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PREFACE 


Who Should Reed This Book 


The manual contains both introductory and reference. 
information. Each chapter is divided into description end 
commands The description section introduces the concepts of 
the system. The command section describes the commands in 
alphabetical order. 


This menual contains information not published in previous 
manuals. In addition, the presentation of the material he> 
been improved for better user understanding. 


Chapter Summery 

This manual is divided into seven chapters: 
Chapter 1 -- Introduction 
Chapter 2 -- Monitors 


-- Di tic Runtime Services 
-- UPDRT Utility 

-- PATCH Utility 

-- SETUP Utility 

-- XTECO Utilit 

-- Batch Contro 
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Each chapter has several examples of actual usage. 
The appendixes provide reference information, as follows: 


Appendix A -- Glossary 

Appendix B -- Command ry 
Appendix C -- Devices rted 
Appendix D -- Componen S 
Appendix E -- Building XXDP 
Appendix F -- User Tips 
Appendix G -- Error Messages 


There are two conventions used in presenting command formats 
throughout this manual. rirst, a field, or item, ine 
command that is ea variable (such as a file name) is denoted 
by the use of lower case characters. Fields shown in upper 
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case characters must be entered exactly as shown. Second 
optional fields in @ command are enclosed in square C"C)") 
brackets. XXDP XM commands require only a few characters to 
uniquely identify a command. The required characters are — 
shown in upper case and the optional cheracters are shown in 


For example, consider the following: 


| filnem [addr XXDP SM 
Run filnam [addr XXDP XM 


In the SM monitor. you "R" followed by a file name. In 
the XM monitor, you can type “R“, "RU", or “RUN” followed by 
e file name. the address is optional, as indicated by the 
squere brackets. 


Coaperison of the XXDP V1.1 end V2 Monitors 


The XXDP V2 monitor has the same functionality as the V1.1 
monitor and the following enhancements: 


o Improved console handler to provide video terminal 
support. 


o Improved operator interface so that it is simpler 
to use. 


© Memory mapping capability. so thet the DRS can be 
moved to memory above 28k words and provide space 


for large diagnostics. 


o Reporting capability. which allows data and error 
reports and end of pass information to be saved on 
the system media. 


XXDP V2 required development of a modified Supervisor. All 
diagnostics thet are now compatible with the old DRS will be 
compatible with the new DRS providing they do not manipulate 
the MMU or write inte the V2 DRS and monitor area. 
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Further Informetion 

The following manuals provide additional information: 
XXDP V2 File Structure, AC-U035A-MC 
XXDP V2 Driver Programmer Guide, AC-U036A-MC 


This manuel was prepared by and is maintained by Low End 
Diagnostic Engineering. Comments and suggestions are 
moyeeee. pee uprre Son, jovecs. Seguie refer to the 

phone directory listi or Diagnostic ineering, 
POP-11 syenene. External users should contact their soles 
representative. 
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CHAPTER 1 
INTRODUCTION 


XXDP V2 is the diagnostic operating system for PDP/LSI-11 
systems. 


1.1 Components 
The XXDP system consists of the following major components: 
o Monitor 
o Diagnostic run time services 
o Utility programs 
© Loadable device drivers 


These four components work together to accomplish the system 
functionality. 


1.2 Monitor 

The Monitor is with - st level software and forms the core 
of the eyoten. f the other components require monitor 
support for their y Bh Ky The monitor program provides: 


© Load and execution 


o Console terminal services 


Ll 
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o Batch control 

o File services for the system medium 
The system medium is the storage medium on the device from 
which the monitor is loaded. All other components use the 


terminal services for operator communications and the file 
services for eccessing files on the system media. 


1.3 Diegnestic Runtiae Services 
The Diagnostic Runtime Services (DRS) are an extension of 
the monitor; they provide non-diagnostic function support 
for — tyaee el on age programs. ioe diagnostics 
are commonly refer © as supervisor compatible. Amon 
the functions that the DRS provide are: . 

o Standard operator interface 

o Error message formatting 


o Control of diagnostic operation 


1.4 Utility Progress 
The Utility Programs use the monitor for typing end J 
receiving messages and for loading read/write device drivers 
required for file operations. 
The following utility programs are available: 
o UPDAT 
PATCH 
SETUP 
XTECO 
DXCL 
Documentation for the first four utility programs is 


provided in this manuel. Documentation for DXCL is 
eveileble seperately. 
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1.5 Leoedeble Device Drivers 


The Loadable device drivers are the device handlers used by 
the various utility programs to access storage media and 1/0 
devices. The drivers are resident on the system storage 
media end loaded into memory as required. 


1.6 Cenventions 


Two kinds of conventions ere used in XXDP, namely: terminal 
interface conventions and file conventions. The following 
sections describe these two kinds of conventions. 


1.6.1 Terminel Interfece Conventions 


The console terminal is supported as part of the XXDP 
monitor. The console terminal driver is a simple, 
flag-driven handler. Flag-driven means that no interrupts 
ere and thus unsolicited interrupts do not interfere 


with diagnostic programs. 


The driver makes no distinction between upper and lower case 
cherecters. All printing characters ere supported, but some 
characters have special significance in specific situations. 
The table below lists these speciel characters. This table 
briefly describes the function of the characters. Detailed 
descriptions and examples are left for later sections of 
this manuel. 

Cher Use 
delimit a device specification (e.g., DUO:) 
start comment line in a batch control file 
beginning of a three character extension in 
in a file name 


? “wildcard” character in file name 

* “wildcard” specificationin file name 

. seperator between input and output 
specifications in a command 

< equivalent to “=" 

/ command switch 


In addition, the terminal driver supports the four control 
cheracters listed in the table below. Control characters 
depicted with en .i>-errow are entered by pressing the "CTRL" 
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key and the designated letter at the same time. 
Char Use 


rc stop current activity and return 
control to program (testable in batch 
control file) | 

tZ stop current activity and return 
control to program (not testable in batch 
control file) 


tU delete entire line of input so new 
_ line can be typed 
tS inhibit typing CXOFF) 
Q resume typing (XON) 
+X resume activity after WAIT command in 


betch control file 


1.6.2 File Cenventions 


XXDP files ere specified by @ name and extension. The 
format of a file specification is: 


file-naeme [.ext] 


File-neme can be from one to six characters in length and 
the extension (ext) can be from one to three characters in 
length. The name and extension are separated by a dot (.). 
Only ealphenumeric characters (A-Z 0-9) can be used and 
speces may not be imbedded. Sample file names: 


UPDAT .BIN 
oi” 


ES 
XMONCO.LIB 


X¥XDP allows the use of the wildcard characters “*" and “?” 
in file specifications. The “?” is used as a substitute for 
e character and “s" is used as a substitute for a string of 
cheracters in a file specification. 


For exemple, if you want ea list of all the files with the 
3 ete extension on 8 medium, you can give the specification 
"se, af” 

other examples of the wildcard characters are: 


¥MON??.LIB all files whose name starts with 
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XMONe .LI8 
XMONCO. ¢ 


XMONCO. 22? 


1.6.2.1 Extensions 


the cheracters “XMON” and ends 
with any two other’ valid 
cheracters (or nulls) and have 
the extension "LIB" 


seme effect as above 


ell files with the name "“XMONCO" 
and any extension 


seme effect as above 


Some extensions are used to identify particular file types. 
For example, batch control files have ".CCC” extensions. 
Below 's e table of extensions that have particular 


meanings. 


BIN Executable program file that may 
not be run or loaded in batch control 


operation 

BIC Executable program file that may 
be run or loaded in batch control 
operation 

SYS System file : 

ccc Batch control file 

06 J DEC/X11 Fee module 

LI8 Librery file 

7x7 Text file 

BAW ¥TECO backup file 
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CHAPTER 2 
THE MONITORS 


The XXDP V2 eporeting system consists of two monitors. The 
XM monitor and the SM monitor. The XM monitor is used when 
®@ memory man t unit exists on the system and passes the 
requirements for booting this monitor. The SM monitor is 
booted by e chain file user request or in cases when the XM 
monitor cannot be booted. The SM monitor emulates the | 
capabilities of the XXDP V1 monitor, with some restrictions 


This chapter describes the monitor and then list the 
commands for each monitor. 


2.1 Description 


The V2 monitor is simple to boot, configure and use. 
monitor is relocatable and thus rts the loading of 
current diagnostic products. It self-sterts if all but a 
1.5Kw reserved section is corrupted during diagnostic 
operations. The monitor does not rely on hardware 
interrupts for its operation in order to minimize dependency 
on hardware functionality and impact of malfunctioning 
equipment. 


2.1.1 WMeniter Size end Components 


kt load time the XXDP monitor is ebout 8K words in size and 
consists of three major sections: secondary bootstrap, 
initialization code and the runtime monitor code. The 
secondary bootstrap is loaded into memory eat boot time and 
loads the remainder of the monitor into memory. The 
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imitializetion code gathers certain system information and 
relocates the runtime monitor. The runtime monitor is the 
code that ‘s_used to cerry out the various operator ' 
ee ae The stert up process is described in more detail 
be. Ow. 


The runtime monitor consists of five sections: 


© read-write device driver -- loads programs from the 
system medium end reads betch control files. 


o console terminal driver 


monitor services handler -- processes requests for 
monitor services thet ere made by utility programs 
vie the EMT instruction. 


© operator interface handler -- processes operetor 
commends from the console terminal. 


© betch control hendler -- processes batch files from 
the system medium. 


"he runtime monitor is epproximately 2K words in size. 
Since older diagnostic frosrens expect the monitor size to 
be 1.5K, the monitor's lower .5K may be overwritten by oa 
Giegnostic program and then later restored by the monitor. 


2.1.2 Diegnestic Requirenents 


Memory end CPU di tics thet ere compatible with XXDP V1 
are compatible with XXDP V2. They must maintain the 
integrity of the 1.5 kw eree et the top of the first 28 kw 
of memory. XXDP XM auto-boots if the monitor is destroyed, 
but sll conditions may not be fully restored. 


The following is a list of CPU's presently known to have the 
“4 support required to be supportable by the XXDP XM 
monitor: 


11/23's, Micro PDP-11, 11/73 


Unibus: - 11/24, 11/34, 11/35, 11/40, 11/744, 
11/45, 11/70, 11/84 
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2.1.3 Herdvere Requi resents 


nanery men t is required for XXDP XM monitor to 
operste. If there is a failure in the MMU, the system 
reports the error and boots the XXDP SM monitor. 


Any additional dete helpful for determining the cause of the 
problem is elso reported, but XXDP is not intended as a 
diagnostic so it does not perform rigorous error 

detect ion/report ing. 


2.1.4 Diegnestic Restrictions 


Stagrantces thet interfere with the monitor EMT and TRAP 
vector sree cen not use system calls. Many SYSMAC 
diegnostics do this es normal operation when they load and 
also when they run. 


Restriction: The XXDP SM monitor requires minimum 16K words of 
memory . 


Explanation: The boot section requires Bkw of Senery plus 
room for the monitor also any diagnostics that 
require the PDP-11 Diegnostic Supervisor will 
require this minimum envi ronment. 


Restriction: The integrity of the 1.5kw base monitor or root 
at the top of the first 26kw memory must be 
maintained. Failure to do so will require a manual 
reboot for contiuned system operations. 


Explenet ion: This root required to restore the monitor. 


2.1.5 XP System Stert-up Procedure 
Follow these steps to stert up the system: 


1. Helt the processor (after making sure that any 
operating softwere hes been ‘Corey shut 
down ). t/load your XXDP medium. If you are 
working on a system thet has unknown hardware 
or make sure the load device is write 
6: sebdiec. 
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Re-enable and boot the processor. 


When the monitor has successfully loaded, it 
identifies itself and gives the drive number from 
which it wes booted (multidrive devices only) and 
the memory size An example is: 


XXDP-SM SMALL MONITOR VERSION 2 
BOOTED FROM DYO? 

24 KW OF MEMORY 

NON-UNIBUS SYSTEM 


The message in the exemple above is printed after 
booting from an RX02 with the XXDP SM monitor on a 
a with 24K words of memory, using drive 0. 

The monitor then relocates the runtime monitor code 
to the top of available memory (up to 28K words in 
this case, but it could load into extended memory 
if the XM monitor were booted) and transfers 
control to this code. 


When these steps have been successfully completed, the 

mon: tor yx a dot (.) to prompt for c : The ; 
commands for the XXDP SM and XM monitors are given later in 
this chapter. 


2.1.6 XXDP Stert-up Process 


When you boot the load device, the first physical block of 
data on the medium is loaded into the first 256(10) words of 
memory. This date is the secondary bootstrap. Control is 
passed to it from the hardware, or primary, bootstrap. The 
secondary bootstrap reads the remainder of the monitor from 
the load medium into memory. When the loed is complete, the 
secondary bootstrap passes control to the initialization 
code and the boot process is complete. If a detectable 
error occurs during the secondary bootstrap operation, the 
processor will halt. 


If the boot process is successful, the boot performs the 
following functions: 


1. Reads and executes the “BOOT.CCC” chain file and 
cote conditions from this file (either SM or 
J . 
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2. Sizes memory (up to 124K words) and sizes for the 
presence of standard line or programmable clocks 
CKW- Lit ond KW-11P), processor type, and interrupt 


integrity. 
3. Verifies hardcore requirements 
Reports any errors found 


Informs user if booting SM monitor instead 
of XM monitor Cif mot im QUIET mode). 


4. Loads end locates the monitor to the top of —— gh 
XM is normally loaded. IF the XM monitor cannot 
loaded or if the BOOT.CCC file instructs otherwise, 
the SM monitor is loaded. 


5. Identifies the monitor if not in QUIET mode. 
6. Sterts the monitor. 


The BOOT. | file is only executable by the boot section of 
commands. The 


code. and onl ~~ ae eng er her the SM or QUIET . 
XDP XM monitor into QUIET mode and 


vee the “the SYSTEM en-cec™ a. file. Only one of these 
commands c 


If the system te tee. enqes ~ the — XM ~ gl of i 
memory management unit is no reting properly, 
SM eeniter starts. Since the X iP SM monitor is not capable 
Ce operation, the QUIET command is ignored by 

1S mon:tor 


~ xXDP > assumes you ge epareting vit with Bg -type (60 
z) power you ere using European- power « 
you must modify the monitor. Lanes *ee ¥5 fa in xxdP 
conteins an indicator or power type for 60 Hz and 

non-zero for 50 Hz. Chapter 4 on SBDAT explains how to 
modify files, but e brief example is given here. 


aR UPDAT 
LOAD DYO:XxDPSM.SYS 


H2 


—_——_— —_—— ae | 


—-— —<— - 


SEQ 0020 
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MOD 1000 
001000 900000 1 


LOAD DYO: XXDPSM.NEW 
DUMP DYO:XXDP??.NEW 


The underlined portion ¥, the above exemple is typed by 
XXDP. The user hes modified the monitor end saved it on 
the f loppy diskette in drive 0, giving the monitor a new 
extension to prevent deleti the old monitor. The CREATE 
command cen be used to make the device booteble. 


2.2 SM Menitor Coamends 


This sections describes the SM monitor commands. Note that 
the — command is no longer supported under the XXDP SM 
moni tor 


The commands for the XXDP SM monitor ere: 


run @ program 
load e program 
stert ea 


am 
run e batch job (chain) 
list directory of load medium 
—— ee drive for system device 
type help informati 
TEST run e batch file called SYSTEM.CCC 


oe commands have optional =e which consist of ea 
single cherecter preceeded by @ “/". Switches are used to 
mod’ Fy the command function. 


4rmMmoowr w 


Le 


ocentiiendl —_——_— 


— —_—— — ———- - 


SEQ 0021 
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2.2.1 Chein Commend 


The chain command is used to initiate execution of a batch, 
or chain, file. The file must be on the system medium and 
~— a e .CCC extension. Some batch operations accept 
Swi tenes. 


The format of the chain command is: 
C filnem[ /switches) 


Chapter 8 of this manuel describes batch control in detail. 
Example: 
C XTEST/RX 


This command initiates execution of the file XTEST.CCC. In 
this chain file you can test for the RX condition 
execute different sections depending on this switch. 


- —_—— —_——<— < «— eee 


Je 


—————— a 


SEQ 0022 
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2.2.2 Directory Commend 


The directory command is used to obtain a list of all the 
files on the system medium. This list contains five items 
of information: the entry number, the complete file 
specification (name and extension), the date the file was 
created, the 1 h of the file in 256 (decimal) word blocks 
end the number of the first block in the file. Most files 
ere “linked”; that is, their blocks are not in order on the 
medium. A few files are contiguous; that is, their blocks 
ere in order on the medium. sg ae files are noted in 
the directory by e “C” following the date. 


The directory utility (DIR.SYS) and the read/write device 
driver for the system medium type must be on the system 
medium in order for the directory command to work. If one 
of these files is not on the medium, the monitor types an 
error message. 


The format of the directory command is: 


D{/LI(/F J 


There are two optional switches for the directory command. 
The “/L“ switch causes the directory to be printed on a line 
printer rather than the console terminal. The “/F" switch 
causes the directory to printed in a short form, which only 
gives the entry pat Bn and file name. 


Directory Long Form 


ENTRY@ FILNAM.EXT DATE LENGTH START REVISION 
1 XXDPSM.SYS O02-JUN-79 12 000100 A.0 
2 DU -SYS 02-JUN-79 5 000120 8.1 
3 DY -SYS 02-AUG-79 6 000066 A.2 


Directory Short Form 


1 XXDPSM.SYS 
4 -SYS 


DU 
3. «~DY .SYS 


K2 


SEQ 0023 
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2.2.3 ENABLE 

The enable command is used to designate a different drive as 
the system Gov ice. For exemple, if you booted the system 
from +e 0 of an RX02 and later wanted the monitor to use 
drive 1 es the oyeten device (that is, as the default 
device), y you could do this without re-booting the monitor by 
using the enable command. 


This command is velid for multi-drive devices only and 
effects drives, not controllers. 


The format of the command is: 
E drive-number 
An example of the enable command is: 
E 1 
This command enables drive 1 as the system device. 


— - TT 


L2 


—— ea ae ee 


——_—— =e _ 


SEQ 0024 
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2.2.4 WELP 
The help command provides a brief summary of XXDP commands. 
The contents of a file named “HELP.TXT" are typed/or inted 
and this file must be on the system medium. ere is 8 
switch to cause the summary to be printed on a line printer 
instead of the console terminal. 
The format of the command is: 

H{/L] 


Exemples of the help command ere: 


4 type the XXDP command summary on the console. 


H/L print the XXDP command summary on the line 
printer. 


or ee ee ee 


SEQ 0025 


i ee - 
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2.2.5 Load Commend 

The load command is used to load a file into memory. This 
command can be thought of as the first half of a run 
commend. The program is not started. 


As in the run command process, the full file name of the 
progrem thet was loaded is printed. All restrictions in the 
run commend apply. 
The format of the load command is: 

L filnem[ .ext) 
Some examples of the load command: 


L DIAG Cload DIAG.BI?) 
L ZDJCA2.NEW Cload ZDUCA2.NEW) 


ee ee 


~* — ee —— EE ee mmm 


SEQ 0026 


ee ee ee eee we 


——_— a tr cm, mn 
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2.2.6 Run Coamaend 


The rum command is used to load and start a program thet is 
stored > the load. or system, medium. (Note: the run 
commend is @ combination of the Load and Start commands 

deacr ibed below.) The progrem must be an executable file. 


The formet of the run commend is: 
R filnem[.ext) [addr] 


The file name must be e standard XXDP file name (see Chapter 
1 If the extension is omitted, a default extension (.BIN or 

BIC) is used. If the medium contains a file with the given 
ee end both default extensions, the first file found is 


After the program is found and loaded, but before the 
program is started, the full ? file name is printed to van! Fy 
the load. This report is useful in determining which of 
possibly several programs on a medium is being run after a 
wildcard specification. 


The file is started at the transfer address in the file (or 

at 200 octal in the absence of oe trensfer address). You can 

spec: ty e starting address with the run command, if you want 
ca 


the fi to stert et oe different point. 
Some examples of the run command: 
R UPDAT (load/stert UPDAT. gg 
R SAMPLE . XXX (load/stert SAMPLE. Xxx) 
R RXDIAG 204 (load/stert RXDIAG.BI? at location 204) 


wildcard characters are permitted in the file specification. 
The fiest file found that fits the wildcard description is 


wsec. 


B3 


SEQ 0027 
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2.2.7 Stert Coamend 


The start commend is used to start ea file that has been 
previously loaded into core by a load command. No commands 
should be issued between oe load and start command since the 
progres loaded will most likely be overwritten. The purpose 
of this command sequence is to allow the user to load ea 
program, halt the processor, modify memory contents, restart 
the monitor and start the program. 


The format of the start command is: 
S (eddr) 
If you do not give e starting address, the monitor la 


the program at the trensfer address in the file. — 
default sterti eddress for files without specific transfer 


addresses is Coctel). 
Some examples of the start command: 
L RXDIAG (load RXDIAG.BI?) 
S (start at transfer address) 


L RXDIAG (load RXDIAG.BI?) 
S 204 (start at 204) 


LO AL A LE AR 


CS 


~- — a oe = 


SEQ 0028 


DS 


SE 
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2.3 M Meniter Commands 


This section describes the XM monitor commands. Note that 
the F ILL command is no longer supported under the XXDP XM 


mon tor. 
Tre XXDP XM monitor commands sre summarized below: 
8007 Boot e device 
RUN run @ Pp am 
LOAD load e program 
START stert @ program 
CoPy Copy e file or device 
CHAIN run ea batch job (chain) 
DATE Set the date or report the date 
DELETE Delete a file 
DIRECTORY list directory of load medium 
ENABLE enable alternative drive for system device 
HELP type help information 
INITIALIZE Initialize e device : 
PRINT Print e file on the system line printer 
RENAME Rename a file to @ new name 
SET Set device or system peremeter 
TYPE Type a file 


Some commands have optional switches. See command syntax 
below. Switches are used to modify the command function. 


=o © © —e_— ——_— eee 


+ 
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2.3.1 Commend Syntex 


The system eccepts commands as either: (1) a complete 
string containing all the information necessary to execute oa 
commend or (2) es_e partiel string. In the latter case the 
system prompts for the rest of the information. 


Generel syntex for ea command is: 


command[ /switch] input-fi lespec 
output - fi lespec 


or 
command[ /switch) 


promptl? input-fi lespec 
prompt2? output-fi lespec 


where: 

command is the command name 

/switch represents es command qualifier that 
specifies the exact action to be taken. 

promot represents the keyboard monitor prompt 


for more information. An appropriate 
prompt will be printed only if an input 
or output file of device specification 

is omited. Not ell commends will print 
prompts. This is a feature of the monitor 
only. UPDAT does not have this feature. 


input-filespec represents the file on which the action 
is to be teken. 


output-filespec represents the file that is to receive 
the results of the operation. 


SEQ 0030 


rg 
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A filespec represents a specific file and the device on 
which it is stored. Its syntex is: 


dev: filnam.typ 


where: 

dev: represents a device name. If the name is omitted 
then the system device is assumed by default. 

fi lnem resents the one- to six-cheracter name of file. 


Wildcard characters are permitted in the file 
specification. 


.typ represents the one- to three-character file type. 


2.3.2 Apbrevieting Keyboerd Coamends 


Although keyboard commands are all English-1 words 
end therefore easy to use. it can become tedious % type 
words like PRINTER and INITIALIZE frequently. Abbreviations 
can be used which are the minumum number of characters that 
are needed to make the command or option unique. In the | 
following sections the required part of the name is shown in 
upper case and the optional part in lower case. 


—_———— eee 


SEQ 0031 
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2.3.3 @GO00T Coamend 


The poot commend directs the monitor to boot mamner ~w 


monitor from another XXDP device. This command 
persed into e format that is enountenbe to UPDAT ana a 
control is passed to UPDAT to boot the device or system 


specified. 

The format of the boot command is: 
Boot dev: 

An example: 
B DUO: 


The appropriate device handler must be present on the system 
dev ce. 


GS 


SEQ 0032 
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2.3.4 CHAIN Command 

The chain command is used to initiate execution of a batch, 
or chain, file. The file must be on the system medium and 
—— — e .CCC extension. Some batch operations accept 
Swi tcnes. 


The format of the chain command is: 
CHAIN filespec [/switches] 
Chapter 8 of this manuel describes batch control in detail. 


H3 


—_—— I 


SEQ 0033 
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2.3.5 COPY Commend 


The copy commend performs _e veriety of file transfer and 
maintenance operations. The command line is parsed into a 
format thet is eccepteble to UPDAT and then control is 
pessed to UPDAT to perform the edkten specified. 


The format of the copy command is: 
COpy [switch-list] input-filespec output-fi lespec 
The following switches can be used: 


/Boot -- copies the root monitor from the input 
device into the boot block of the output 
device. The command places the 
appropriate secondary bootstrap in the 
boot block and places the monitor file 
on the medium in a predetermined 
section. The root monitor consists of 
XXDPSM.SYS merged with driver of the 
output device. 


/Files --copies ell files from the specified input 
device onto the specified output device. 


/DEVice -- copies 8 a in image mode to a like 
device. A copy to ea device which is not 


identical eoupee the command to abort. 
Also bad block devices may also fail 
during execution of this command. 


/DElete -- copies a file or files from the 
epee: tree input device onto the 
specified output devic 


e and 
automatically delete ~~ file if it 
elready exists. 
Example of the use of the copy command: 
COPY A.BIN DYO: 


This command copies the file A.BIN from the system device to 
DYO: using the same name. 


I$ 


——_——_——— 


SEQ 0034 
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2.3.6 DATE Commend 


The date command lets you inspect or to set the current 
system date. 


The format of the command is: 
DAte [ dd-mmm-yy ] 
dd represents the dey (a decimal number from 1 to 31) 


mam represents the first three characters of the name of month 
yy represents the year (a decimal number from 83 to 99). 


If the command is given with ea date, that date is set. If 
the une iS given without a date, the current date is 
prin - 


DATE 18-MAY-83 Sets the date 


DATE Obteins the current date 
18-MAY-83 


If no date is presently set a default date of 1-JAN-83 is 
used. 


‘ xXxm—————— « ——_—_ — 


7? 


—_— — —_—<~ — 


SEQ 0035 
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2.3.7 DELETE Command 
The delete command deletes the specified files. The name of 
each file that is deleted is printed and, for tape devices, 
the tape is rewound after each file is deleted. 
The format of this command is: 

DElete [/NOnames) [/NORewind) filespec 

o /NOnemes -- prevents the printing of the name of 
each file as it is deleted. 


9° /NORewind -- prevents e tape drive from rewinding 
between files when deleting multiple files. 


An example of deleting a file: 
DELETE DKO:ABC.BIN 
This command deletes the file ABC.BIN from the device DKO. 


K3 


SEQ 0036 


LS 
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2.3.8 DOIRECTORY Commend 


The directory commend is used to obtain a list of all the 
files on the system medium. This list contains sive items 
of information: the entry number, the complete file 
specification (name and extension), the date the file was 
created, the 1 of the file in 256 (decimal) word blocks 
end the number of the first block in the file. Most files 

ere “linked”; thet is, their blocks are not in order on the 
nediun. A few files are cont iene that is, their blocks 
ere in order on the medium. nt ae files are noted in 
the directory by a "C” following the date 


When the directory command is given, the monitor parses the 
conan line, loads the UPDAT Stility and passes control to 


The format of the directory command is: 
Directory [/Printer] [/Fast] 
There are two optional switches for the directory command. 


o /Printer -- causes the directory to be printed on a 
line printer rather than the console terminal. 


o /Fast -- causes the directory to printed in a short 
form: entry number and file name. 


Directory Long Form 


ENTRY@ FILNAM.EXT DATE LENGTH START 


1 XXDPSM.SYS 02-JUN-79 12 000100 
2 DY -SYS 02-JUN-79 5 000120 
> GR .sYs 02-AUG-79 6 000066 


Directory Short Form 


1 XXDPSM.SYS 
2 DY aVe 
3 DIR .SYS 


————— ee ee ee ee 


SEQ 0037 
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2.3.9 ENABLE Commend 


The enable command is used to change the drive that the | 
monitor considers to be the system device. For oxeepie. if 
the user had booted the system from drive 0 of an RX02 and 
leter wanted to have the monitor use drive 1 as the system 
device (thet is, as the default device), he or she could do 
this without re-booting the monitor by using the enable 
commend. This commend is valid for multi-drive devices only 
and effects drives, not controllers. 


The format of the commend is: 
Enable drive-number 
There must be valid XXDP V2 media in residence on the 


specified drive or the system will not allow the command to 
complete and an invaild device error will be invoked. 


——_— ee a ee 


<_< — eee ee tee ws 


SEQ 0038 


ee a ee 
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2.3.10 HELP Commend 
en ~~ - command is used to obtain a brief oymnery of XXDP 
The contents of a file named “HELP.T are 
typea/er inted. and this file must be on the Sate medium. 
is @ switch to cause the summary to be printed on a 
line printer instead of the console terminal. 
The format of the commend is: 


Help [/Printer] 


o /Printer -- lists the help on the printer. 


SEQ 0039 
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2.35.11 INITIMIZE Commend 


The initialize command is used to clear and initialize ea 
device directory. 


The format of this command is: 
Initielize device 


The initialize command initializes a medium by clearing the 
bit map (random eccess devices) or writing an end-of-tape 

mark Cooquent ial access devices) and placing an empty 
directory on the medium. 


All data on the medium prior to e this operation is 
ipretrievably lost after the operation. The monitor 
makes no ettempt to determine what is on ea medium 
end will destroy customer date. 


A warning is printed whenever this command is invoked, 
stating which device is involved. The user must then verify 
thet the zero operation is to take place. 
An example of the command is: 
INI DY1: 


There is no default for the device. The device must be on 
line and write-enabled. The following warning is issued 
after the command is entered: 


USER DATA ON dev WILL BE DESTROYED! .... PROCEED? (Y/N/CR=N) 


The « .y answer that confirms the user's intent to carry on 
‘Ss “Y’. 


An additional warning message is printed if you specify the 
system device in this command. 


INITIALIZE SYSTEM DEVICE .... PROCEED? (Y/N/CR=N) 


I* you wish to proceed with the process, you must type 


._——-a—~- A 


SEQ 0040 
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2.3.12 LOAD Command 

The load commend is used to load a file into memory. This 
command cen be thought of as the first half of a run 
commend. The program is not started. As in the run command 
process, the full file name of the program that was loaded 
i's orinted. All restrictions in the run command apply. 


Tne format of the load command is: 
Loed fi lespec 


Some examples of the load command: 


LOAD DIAG Cload DIAG.BI?) 
LOAD ZDUCA2. NEW (load ZDUCA2.NEW) 


C4 


SEQ 0041 
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2.3.13 PRINT Coamend 


The PRINT command lists the contents of one or more files on 
the specified device to the system line printer. 


Tne formet of this commend is: 
Print [/Norewind]) fi lespc 
The ‘Norewind switch prevents e tape drive “— t this suit i‘ 
c 


between files when printing multiple files. If this swi 
"S$ not given, the tape is rewound after each Pile is 


pr nted. 

Some examples of the print command: 
PRINT DUO:SYSTEM.CCC 
P/N MM]: 0. TXT 


D4 


SEQ 0042 
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2.3.14 RENAME Coamend 


The rename command is used to change the file agec i fication 
of an existing file without doing a transfer. The name of 
the file as recorded in the directory is changed, but there 
iS No movement of dete. 


The format of the command is: 

REname input-filespec output-fi lspec 
In the command syntex illustrated ebove, input-fi lespec 
represents the file to be renamed, and output-fi lspec 
represents the new name. The device ified in filespec 
iS assumed to be online and write-enabled; device must be 
the same for both input and output. This command cen not be 
used on eo tape device. 


Exemples of the rename command: 
RENAME DY1:DIAG.OLD DY1:DIAG.BIN 
Tris command renames the file DIAG.OLD om DY1 to DIAG.BIN. 


E4 


SEQ 0043 
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2.3.15 RUN Commend 


The rum commend is used to load and start ea program thet is 
stored on the load, or system, medium. (Note: the run 
commend os combination of the he lead and start commands. ) The 
eregres t be an executable file. These are only files 
wie BIN 0 or .BIC extensions to their names (such as, 


The format of the run commend is: 
Run filespec [addr] 


The file neme must be e standard XXDP file name. The 
default extension is .BIN or .BIC. If there is a file with 
both extensions on the medium, the first file found will be 


After the program is found and loaded, but before the 
progrem is started, the full file name is printed to verify 
the load. This is useful in determining which of possibly 
several programs on a medium is being run efter ea wildcard 
specification. 


The file is started at the transfer address in the file Cor 
et 200 octel in the absence of a transfer address). If you 
want to stert et oe different address. you can specify the 
starting address. 


Some examples of the run command: 


RUN UPDAT (load/stert UPDAT.BI?) 
RUN SAMPLE. XXX (load/stert SAMPLE .XxXxX) 
RUN RXDIAG 204 (load/start RXDIAG.B1? 


at location 204) 


ui deere characters are permitted in the file specification. 
The first file found that fits the wildcerd description will 


be run. 


F4 


SEQ 0044 
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2.3.16 SET Commend 


The set command changes device handler characteristics and 
certain system configuration parameters. 


The format of this commend is: 
SEt physicel-device-name ] condition 
item ) 


In tne command syntax ebove, “physical-device-name" 
represents the the device hand ler whose characteristics need 
to be modified. The argument “item” refers to a system 
peremeter thet needs to be modified. Presently the y= 
system peremeter that is changed by the set commend is 


following: 
SET TT:SCOPE 


This option echos RUBOUT characters as 
back space-space-backspace The default is NOSCOPE. 


SET TT:NOSCOPE 
This option echos RUBOUT cherertere oy onaceoine & the deleted 
cheracters in beckslashes. This is t mode. The 
system returns to this condition on reboot. 

SET TT: QUIET 


The QUIET option prevents the system from echoing lines from 
the chain file or from diagnostics that me pheonley from e 
chain file (providing the diagnostic has 


SET TT:NOQUIET 
The NOQUIET option echos lines from chain files or from 


diagnostics that are running from a chain file. This is 
default mode. 


G4 


SEQ 0045 


H4 
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2.3.17 START Commend 


The start commend is used to start a file that has been 
loeded into core by a load command. No commands should be 
issued between e load and start command since the program 
loaded will most likely be overwritten. The purpose of this 
commend sequence is to let you load e program, halt the 
processor, modify memory contents, restart the monitor and 


stert the progres. 
The format of the start command is: 


Stert [addr] 


You can enter eae starting address. The monitor starts the 

progrem et the transfer address in the file if you don't 

give e sterting eddress. The default starting address for 
iles without specific transfer addresses is 200 (octal). 


Some examples of the start command: 


LOAD RXDIAG (load RXDIAG.BI?) 

T (start at transfer address) 
LOAD RXDIAG (load RXDIAG.B8I?) 
START 204 (start at 204) 


SEQ 0046 
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2.3.18 TYPE Commend 


The type command prints the contents of a file on the 
terminel. 


The format of the command is: 
Type [/Norenwind] filespec 
In the command above the filespec represents the file or 


files to be typed. Wild cards are accepted in the py a 


The entire command may be on one line or the system can 
relied on to prompt for information. The type command 
prompt is “FILE?” 


o /Norewind -- prevents a tape drive from rewindi 
between files when typing multiple files. Default 
iS @ rewind after each operation. 


14 


SEQ 0047 


J4 


CHAPTER 3 
THE DIAGNOSTIC RUNTIME SERVICES 


The Diagnostic Runtime Services (DRS) are the part of the 
XXDP System that control c tible di tic programs. 
DRS is an extension to the the XXDP Runtime Monitor that is 
automatically loaded into memory and started when oe 
compatible diagnostic is run. S also provides. 
non-test-related services (such as, console terminal 
support) to these diagnostic programs. 
This chapter has five parts: 

1. DRS description 
commands 
switches, or command modifiers 
operational flags. 


table building process 


uv & Ww ff 


3.1 Description 
There are two DRS systems used by XXDP: 
o DRSSM -- a small DRS system 
o DRSXM -- an extended DRS system 
When the XXDP SM monitor is booted, the corre ding small 


ORSSM is loaded for the diagnostic. When the XXDP XM monitor 
is booted, the lerger DRSXM is loaded for the diagnostic. 


— ——_— ee  & 


SEQ 0048 
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The DRSSM provides the same capablities that the old DRS did 
for XXDP V1.1. The DRSXM allows larger diagnostics to run 
and provides en additional command as described below. 


All diagnostic programs that are compatible with DRS share 
some importent common features. Because of these features 
they have identicel structures, re to the same general 
set of commands, report errors in the same way, gather 
herdwere end operationel data in the same manner and are 
therefore easier to use and control from both a user and 
system point of view. 


If you ere unsure of which diagnostic programs on a 
perticuler medium are DRS-compatible, you can use the SETUP 
erie’ to list these diagnostics. Chapter 6 describes 


3.1.1 ORS Stert-up 


The otert-sp presets for DRS is straightforwerd. When you 
issue en XXDP run command, the diagnostic is loaded and 
sterted. The first eg the diagnost:c does is to execute 
an EMT instruction that transfers control back to the XXDP 
monitor. XXDP then loads DRS from the system medium. 


The DRS file is DRS??.SYS where “??"” represents the 
designator for the small DRS (SM) or large DRS (XM). DRS 


Sizes memory uSing memory management prior to goi into 
command mode. If this hardware has problems, BRS does not 
stert properly. You must run memory management diagnostics 
if you encounter this problem. 


3.1.2 ORS Concepts 
You should be eware of several concepts about DRS. 


o CONSOLE COMMANDS - DRS communicates with you 
through the console terminal. There sre eleven 
commands available for controlling DRS operation. 
Unlike older -type diagnostics, DRS does not vary 
its operation based upon starting address or 
“switch registers”. 


K4 


—_———— ——-—- - 
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° 


COMMAND MODIFIERS (SWITCHES) AND FLAGS - You can 
elter the effects of a particular command by 
specifying e “switch” when the command is given. 
For example, unless otherwise specified, most 
commands wiil effect all units (devices) that the 
diagnostic can test. A switch can be used to limit 
the effect of commands to certain units only. 


UNITS - The diagnostic acts upon specified 
hardware. Each individual hardware “entity” is 
referred to as a unit-under-test (UUT) or, most 
commonly, as @ unit. DRS is equipped to handle up 
to 64 units. You refer to a unit by a number, The 
first unit is "0". Units are numbered according to 
the order in which they were specified (see 
HARDWARE TABLES below). 


HARDWARE PARAMETER TABLES - DRS-compatible 
diagnostics do not autosize (determine hardware 
information by performing bus-related tests). You 
must give the diagnostic the information at the 
hardware under test that is necessary. This 
information is stored in a set_of tables called 
“hardware paremeter tables". There is one table 
for each unit to be tested. The specific 
ee ee is 4 pga upon — ee 

iagnostic. iagnostic program prompts 
operator for the information it needs for each 
unit, starting with unit 0. The important concept 
thet you must grasp is the concept of a “table 
driven diagnostic” in all of the information about 
o anmars unit is contained in ea table specific to 
thet unit. 


SOFTWARE PARAMETER TABLE - There are operational 
parameters that you cen select thet affect the way 
in which e particular di ostic will function. 
This information is placed into a table of date 
called the “software parameter table”. This table 
(for those readers familiar with earlier processor 
designs) takes the place of the switch register. 


PASS - A pass, or unit of Sagpestse operation, is 
defined to be the execution of all specified tests 
for all active units-under-test. 


SEQ 0050 


a 
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o TEST - DRS diagnostics are divided into independent 
stuctures celled tests. You can run all tests ina 
diagnostic or select any subset desired. 


3.1.3 Error Messeges 


When ae diagnostic detects an error in the device being 
tested, it calls upon DRS to rt the error to the 
operator. There are three levels of error messages: 
header, basic and extended. The first message level 
supplies some general information about the error, as shown 
in the example below: 


ZNAME HRD ERR 00002 ON UNIT 5 TST 012 SUB 000 PC:013134 
The information given in the header is: 


diagnostic name - “ZNAME" 
error type - “HRD* 
error number - "00002" 


subtest number - “0” 
location of error call to DRS - "013134" 


The error number is for identification and is not a running 
totel of the number of errors that have occurred. 


The basic error level is used to give a short, simple 
description of the error. The extended error level is 
Sptesiio used to give supporting information such as 
register contents at the time of the error. For example: 


ZNAME HRD ERR 00002 ON UNIT 5 TST 012 SUB 000 PC:013134 

REGISTER FAILED TO CLEAR AFTER BUS RESET 

CSR: 000000 SCSR: 010000 ERRREG: 
The first line is the header message, the second is the 
besic message and the third line is the extended message. 
Error messages are divided into levels in order to give the 
operator flexibility in determining what portion(s), if any, 
of the error reports will be displayed or printed. 


M4 


SEQ 0051 
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3.2 Commends ‘ 


There are eleven commands to the DRSSM and twelve to the 
DRSXM. These commands ere entered in response to the DRS 
ots BD eh o, ‘sound <td the DRS pe sanens. 
efter all specifi iagnostic operations ere completed, 
efter a ORS detected error, after a “halt-on-error” sequence 
and efter DRS has been imeerrveeed by e tC (CTRL-C). These 
ere tabulated below and descri in the remainder of this 
section. The commands are grouped by related function. 


Execution 
START start the di tic and initialize 
RESTART start diagnostic and do not initialize 
CONTINUE continue diagnostic at test that was 

interrupted by a _tC 

PROCEED continue from an error halt 

Date Collection 
REDIRECT redirect error prints and statistics to 


another unit and/or the line printer 
Units Under Test 


DROP deactivate a unit 

ADO activate a unit for testing ; 

DISPLAY print a list of device information 
Time , 

TIME set the time of day or display the current 

time of day. 

Flags 

FLAGS print status of all flags 

ZFLAGS reset (clear) all flags 
Statistics 

PRINT print statistical information 
Exitting 

EXIT return to XXDP monitor 


The descriptions below describe the effect of each command. 


SEQ 0052 
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These effects may be modified by the use of switches that 
ere described in the next section. Familiarize yourself 
with the commands before Lys not to use the switches. The 
comaands can be resegn tase y DRS from ea minimum of 
three characters; thus the use of the square brackets. That 
18s eats. start command cen be entered as "STA" or "STAR" or 


= 


SEQ 0053 
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3.2.1 ADO Command 

The add command is used to activate a unit for testing. The 
unt switch is used to specify the unit to be activated (see 
sect'on 2). All units ere initially ective and must be 


ny Pag Rg g bm a by the user or the ¢di tic. The 
units to ectiveted must have already been deactivated. 


“me format of the commend is: 
ADD [/UNIts:unit-number ] 


wnrit-number is the unit to be activated. Section 2 of this 
ceepter describes the unit switch in detail. 


“ne default operation of the add command is: 


o if the /UNITS switch is specified, the given unit 
‘S$ ect: veted. 


o If the switch is not specified, all deactivated 
units are returned to active testing. 


heal 


SEQ 0054 
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3.2.2 CONTINUE Coamend 


The continue commend is used to resume diagnostic operation 
after interrupted by e tC or after a halt-on-error. The 
diagnostic is restarted at the beginning of the test thet 
wes interrupted, not et the first test, es would be the case 
with the RE TART commend. The unit being tested when the 
diagnostic was interrupted remains as the unit being tested. 
You are given the pages to change the software table 
ad ou wish. You are not able to change the hardware 

t es. 


The format of the command is: 
CONtinue [switch-list) 


Switch-list is any valid combination of switches (modifiers) 
for the continue commend. Section 2 of this chapter 
describes these switches. 


The default operation of the continue command is: 


o The testing runs for the number of ses remaining 
in the pass count specified in the last start or 
restert commend. (A pass is defined to be all 
anes tv ae units tested once by all specified 
tests. 


o All flags will remain set/clear as previously 
spec ified. 


caeee of continue command (underlined portions typed by 


+C 
pe CON 
HANGE SW (L) 2 N 


You can also use the stert and restart commands to resume 
G' agnostic execution, but diagnostic initialization will 


taxe place and testing will start with the first unit, first 


test. 


D5 
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3.2.3 OISPLAY Command 


The displey commend is usec to examine the contents of the 
hardwere tebles. All table date for the specified units are 
listeo on the console teruinal. Units that have been 


Cropped ere so desi gneted. 
Tre format of the commend is: 
DISpley [switch-list] 


Switch-list is eny valid combination of switches (modifiers) 
for the displey command. Switches ere described in section 
2 of this chapter. 


“ne default operation of the display command is: 


o All units described in the hardware tables will be 
displayed on the console terminal. 


ES 


SEQ 0056 
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3.2.4 OROP Commend 
The drop command is used to deactivate a unit from testing. 
The urit to be deactivated must be specified using the unit 
switch (see section 2). All units are initially active. 
The format of the command is: 

DROp [/UNIts:unit-number ] 


Unit-number is the number of the unit to be deactivated. 
= ay switch is described in detail in section 2 of this 
cnepter. 


Tre default operation of the DROP command is: 


o If the /UNITS switch is specified, the given unit 
is deactivated. 


o If the switch is not specified, all active units 
ere dropped from active testing. 


FS 


SEQ 0057 


es 
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3.2.5 FLAGS Commend 


The flags command is used to find the current status of the 
ORS flags. Upon receipt of this command, DRS will display 
the stetus of all flags on the console terminal. 

The format of the command is: 


FLAgs 


case of the flags command (underlined portion typed by 


Frags Se1 


flags ere set. 


OR OFLA 
. 


There are two flags thet have been set: IER and LOE. 
(These flags are described |: a later section.) 


SEQ 0058 
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3.2.6 PROCEED Coamand 


The proceed commend is used exclusively with the 
halt-on-error feature in DRS. When halt-on-error is in 


force and the di tic reports en error to DRS, 
returns to c mode. You can issue 7 commands et this 
point. The proceed command is special in thet it restarts 


the diagnostic at the point where it rupereee. the error. No 
initialization is done, the unit-under-test is not accessed 
end the vector space is unchanged. This process allows you 
to examine the state of the unit being tested and then 
continue testing without disturbing diagnostic operation. 


The format of the command is: 
PROceed [switch-list] 


Switch-list is any valid combination of switches (modifiers) 
for the PROCEED command. These switches ere described in 


section 2 of this chapter. 
The default operation of the proceed commend is: 


o the flags (section 3 of this chapter) remain 
set/clear as specified with the previous command. 


H5 


—_—— —— —_— 


SEQ 0059 
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3.2.7 REDIRECT Commend 


The redirect command is available in the DRSX which operates 
from extended memory. This command causes certain 
information to be redirected to a device instead of being 
printed on the terminel. The information that is redirected 
is error information, statistics, drop units, and End of 
Pass information. 


The formet of this command is: 
REDirect (/DEV]) [/LPT]) file-spec 


The /DEV switch allows the name of a device to be 
entered on which the date is to be stored. The 
date is collected in a file named COLECT.DAT. If. 
this file is not present, it is created and date is 
added to it. If the file is present, it is opened 
end date is appended to the end of the file. The 
file is opened at the inning of each pass of the 
diagnostic progrem and closed at the end of the 
pess. 


The /LPT switch causes the information to be 
printed on the system line printer in addition to 
being collected on the device specified by the DEV 
switch. The file is closed any time there is e 
return to command level. A tC or trap causes a 
return to command level. The date of the file is 
the current date and is updated if necessary. 


The command can be executed any time at command level. If 
the redirect is canceled, the above information is output to 
the console terminal. The redirect command can be canceled 
by entering the command without any arguments. 


Exemple: 
DR>RED/DEV:DYO/LPT 
DR> 


Either or both switches can be used in any order. The 
device driver specified in the DEV: switch must be on the 
system media. An error message is displayed on the system 
console if the attempt to load the driver fails. 


The information saved on the stor device/serial line or 
line printer is information normally printed from: 


SEQ 0060 
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1. Error calls, Error block call, and all PRINT? 
calls that are within the scope of that error call 
(for example: the error sub-routine, extended 
error message, etc.) 


2. PRINTS calls 
3. the end of pass printout. 


Information contained in PRINT? calls that are not within 
the scope of the error are not saved and are output to the 
console terminal. 


This data is stored in ASCII form just as the diagnostic 
program passed them to the DRS. No data compression or 
other formatting is accomplished on this information. 


J5 


—— —_— — ae © 
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3.2.6 RESTART Commend 


The restert command, like the start_command, starts the 
di tic from an initial state. The diagnostic 
initielizetion process may be different in response to a 
restert. Please refer to diagnostic documentation for 
details. The vector space is not changed. You only have 
eit to change the contents of the software 

e. 


The format of the command is: 
REStart [switch-list] 

Switch-list is any valid combination of switches (modifiers) 
for the restart command. Section 2 of this chapter explains 
Switches. 
The default operation of the restart command is: 

o All tests ere run on all units. 

o Flags (section 3 of this chapter) are cleared. 


o The testing continues until interrupted by a C or 
by e system error. 


o An end-of-pass message is printed after each pass. 


(A pass is defined to all specified units tested 
once by ell specified tests. ) 


nates 
HANGE SW (L2 2 N 


— a a 


KS 


——-—— — ee 


—— — 


—_—_———- —_—— en + 
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3.2.9 START Commend 


The start command sterts the diagnostic from its initial 
state and should be the first command issued to DRS. All 
initialization code is executed. Refer to specific 
diegnostic documentation for exact nature of the 
initialization process carried out by a particular 

di tic. The “trap catcher" code is reloaded into the 
vector space. (The trap catcher is code that ellows DRS to 
handle and report any unexpected interrupts. ) 


The format of the command is: 
STArt [switch-list] 


Switch-list is any valid combination of switches (modifiers) 
for the START command. The switches are explained in 
section 2 of this chapter. 


The default operation of the START command is: 
o All tests are run on all units. 
o All flags (section 3 of this chapter) are cleared. 


o The testing continues until interrupted by a tC or 
by e system error. 


o An end-of-pass message is “lpooed ihey each pass. 
(A pass is defined to be all specified units tested 
once by all specified tests. ) 


After you issue the start command, you ere asked if you wish 
to change the hardware information. You must answer yes 
(“Y") to this question if there are no existing hardware 
ne. Hardware tables will already exist if they were 
entered: 


1. By @ previous start command sequence 
2. By use of the SETUP utility 


3. By @ programmer who hardcoded tables into the 
diagnostic image. 


You can override existing tables at this point if you wish. 


You ere then asked for the number of units to be tested. 
Enter the decimal number of units. You are asked for 


= 


—_— — = ee ~ 
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hardwere-specific information for each unit according to the 
design of the diagnostic. 


Exemple of START (underlined portions typed by DRS): 


> STA . 
Pa SH 2, 
foneaar diggneatic questions) 


You are asked for the hardware date for “n" units, where "n" 
iS @ decimal number between 1 and 64. Refer to section 4 of 
this chapter for assistence in answering these questions. 
The questions should be obvious and straightforward. If you 
have difficulty with the questions of a specific di tic, 
please refer to the document for that diagnostic or direct 
questions to Diagnostic Engineering. 


After you enter ell hardware date, wes ere asked if you wish 
to change the operational date (softwere table). This is 
purely optional. You do not have to answer ~ software 
date questions unless you want to modify default Ms geet 
operational behavior. Section 4 of this chapter will assist 
you in answering the questions, but please refer to 
——— documentation for explanations of specific 
questions. 


If there are no hardware tables, you get an error message. 
The following example shows what happens when hardware 
tables ere not present: 


>STA ‘ 
wae 


MS, 


SEQ 0064 
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3.2.10 TIME Commend 


The time command sets the time of day or displays the 
gurant ies of day. This command is only valid for 


The format of the command is: 
TIME [hh:mm:ss] 
hh represents the hour (a decimal number from 1 to 23) 
mm represents the minutes (a decimal number from 0 to 59) 
ss represents the seconds (a decimal number from 0 to 59). 
An exemple of setting the time: 
DR>TIME 11:15 
An example of obtaining the time: 


DR> TIME 
11:15:01 


If no time is presently set a default time of 00:00:00 will 
be used and the system will increment from that time. If no 
clock is available on the system an error message is printed 
when the time command is invoked. 


a Ee . 


SEQ 0065 
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3.2.11 ZFLAGS Commend 


So Sraage command resets all DRS flags to their cleared 


The format of the command is: 
ZFLags 


. 
— ————— oe ee er ee ee ~_—- -_ —_—_——_ 


C6 


XXDP User's Guide -- The DRS Page 3-20 


3.3 Seitches 


Switches ere modifiers of command functions. For exemple, 
many DRS commends effect units. Usually ea command of this 
type affects all units specified during hardware table 
build. A switch enables you to limit the effect of the 
command to certain selected units. 


Tre DRS switches are: 


/TESTS:test-list execute only the tests specified 

/PASS: ddddd execute ddddd passes (ddddd = 1 to 65536) 

‘FLAGS: flag-list set specified flags 

/EOP : ddddd report end-of-pass after each ddddd passes 
(ddddd = 1 to 65536) 

/UNITS:unit-list command will affect only specified units 


All switches cannot be used with ell commands. The 
Following table shows which commands each switch may be used 
with. 


TESTS PASS FLAGS EOP UNITS 


© 
La 
SS 
rc 
QR 
ou 
< »< 


®D 
m 
w 
e 
bs) 
4 
»< 
<< 
mM, 
x 
x 


3.3.1 /EOP Suitch 
The /EOP switch is used to specify when end-of-pass messages 
will be printed. These messages indicate the number of 
esses completed and the number of errors found. Default 
S operation is to print these messages after every pass. 
Tre format of this switch is: 


/EOP : number -passes 


SEQ 0067 
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Number-pesses is e decimal number between 1 and 65556. The 
end-of-pess message is printed each time the number of 
pesses specified is completed. 


In the exemple below, the mess is printed after every 90 
pesses. (The under lined certian ie typed by DRS.) ' 


DR >RES/EOP : 90 


3.3.2 /FLAGS Switch 
The /FLAGS switch is used to set DRS operational flags. 
These fl ere described in detail in the next section of 
this chapter. Default DRS operation is all flags cleared. 
The format of this switch is: 

/FLAgs : flag-list 


Flag-list is a list of DRS fl seperated by colons. 
Sleles refer to section 3 of this chapter fer detailed 
descriptions of flags. 


sone gyensaes of the FLAGS switch (underlined portion typed 
y : 


RR Ee /ELAC COE TE 
RoRES/FLA:LOE: IER: BOE 


3.3.3 /PASS Suitch 


The /PASS switch is used to specify the number of passes 
thet @ diagnostic will run. A s is all specified tests 


on ell active units. Default DRS operation is “no limit” on 


pesses. This switch sllows the you to place a limit on the 
number of passes. 


The format of the switch is: 
/PASs : number -paesses 
Number -passes is 8 decimal number between 1 and 65536. 


- EE a 


D6 
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Some ex es of the /PASS switch (the underlined portion is 
typeo by DRS): 


Rae ePAntit 
>RES/PAS:1 


3.3.4 /TESTS Suitch 


The /TESTS switch is used to specify what tests will be run. 
Tre default DRS operation is to run all tests, but this 
switch allows you to override the default. 


The formet of the switch is: 
/TESts:test-list 


Test-list is e list of test numbers separated by colons. If 
the test numbers ere sequential, they can be specified by 
the first and last test number seperated by e dash. 


For exemple. if tests 1. 2. 3 and 4 are to be specified, 
they may be entered as “1:2:5:4" or “1-4". Test numbers may 
be entered in any order, but tests will always be executed 
im numeric order. 


Some examples of the /TESTS switch follow. The underlined 
portion is typed by DRS. 


>START/TESTS:5 
Pe sSTaRt/TES:1:2 
>RES/TES:1:5-9:15 


In the first command, the user selected test 5 omy. In the 
second command, the user selected tests 1 and 2. n the 
— command, the user selected tests 1, 5. 6, 7. 8. 9 and 


3.3.5 AMITS Switch 


The /UNITS switch is used to specify which available units 
ere to be tested. Default DRS operation is to encompass all 
units im the scope of any command. This switch is used to 
limit the effects of a command to certain units. The format 
of the command is: 


E6 
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/UNIts : units-list 


Units-list is e list of unit numbers separated by commas. 
Unit numbers ere decimal numbers from 1 to 64. unit is 
es ged @ number besed upon order of entry into the tables. 
The first unit is unit 1. If the units are sequential, they 
may be specified by the first and last unit number seperated 
by @ dash ("-"). For exemple, units 3, 4, 5, 6 and 7 may be 
specified es “3-7". 
Some examples (underlined portions typed by DRS): 

DR >DRO/UNITS: 1 

8 2>ADD/UNI: 2.5 

8 >RES/UNI:5-9 
The first exemple drops unit 1. The second example adds 


units 2 and 3. And, in the last example, the diagnostic 
restarts with units 5, 6, 7, 8 and 9 being tested. 


3.3.6 Coenmbining Switches 

You can specify es many velid switches, in any order, with a 
command es you wish. Simply string out the switches, one 
after another, on the command line. 

For exemple, if you want to stert a diagnostic and: 


l. test units 1 through 4 only 


2. execute tests 1, 5 and 15 
3. execute 100 passes 
4. only report the end-of-pass date after every 10 
pesses 
3.4 Flege 


Fl are used to set up certain operational parameters such 
@S 100p'ng on error. ek Bl i ere cleared et startup and 
remain cleared until explicitly set using the /FLAGS switch. 
Flags ere also cleared after oe start or restart command 


F6 


SEQ 0070 
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unless set using the /FLAG switch. The zflags command can 
also be used to clear all flags. No other commands affect 
the state of the flags. 


Flag Effect 


ADR execute autodrop code 

BOE “bell” on error | 

EVL execute evaluation (on diagnostics which have 
evaluation support) 

HOE healt on error - control is returned to 
runtime services command mode : 

IBE inhibit all error reports except first level (first 
sores contains error type, number, PC, test and 
uni 

IDR inhibit program dropping of units 

IER inhibit ell error reports 

ISR inhibit stetisticeal reports (does not apply to 
diaqnest igs whic do not support statisticel 
reporting 

IXE inhibit extended error reports (those called by 
PRINTX macro's) 

LOE loop on error 

LOT loop on test 

PNT print test number as test executes 

PRI direct messages to line printer ; 

UAM unattended mode (no manual intervention) 


3.4.1 ADR Fleg (AuteDRep) 


The ADR fleg. when set, causes DRS to execute the “sutodrop" 
code in @ diagnostic. The purpose of this code is to test 
for “device ready” or “device aveilable”. If the unit being 
tested is not ready or available, it is dropped 
(deselected). Not ell diagnostics have autodrop code. _ 
Refer to specific diagnostic documentation to determine if oe 
diagnostic does support this feature. 


3.4.2 BOE Fleg (Bell On Error) 


The BOE flag, when set, causes DRS to issue a “CTRL-G", or 
“pell” cheracter when an error is reported by the 
Giagnostic. This gives en sudible tone at the console | 
terminal. This feature is normally used in conjunction with 


SEQ 0071 
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the sessage inhibit functions. 


3.4.3 EW Fleg (EVeluete) 


The EVL fleg, when set, causes DRS to execute diagnostic 
evaluation code. This is an optional feature and you must 
refer to specific diagnostic documentation. 


3.4.4 WOE Fleg (Halt On Error) 


The HOE fleg, when set, causes DRS to execute oe 
"halt-on-error” sequence when an error is detected by the 
diegnostic. Execution of this sequence does not result in 
en ectuel processor halt. but returns DRS to command mode. 
The exact process is: 


1. When the error is reported to DRS, the error 
eg oe ere printed (unless printing has been 
i i i a 


2. DRS returns to command mode. 


3. The diagnostic is suspended at the point of the 
error report to DRS and the unit being tested is 
left.in the state that it was in at the time of the 


call. 


After DRS has returned to command mode, you can issue a — 
proceed command to resume diagnostic execution at the point 
where it was suspended. You can also issue other commands 


as desired. 


3.4.5 IBE Fleg (Inhibit Besic Errors) 


There ere three levels of eeagtgne io a error report. The 
IBE flag, when set, causes DRS to inhibit the second and 
third level of error reports. The first level, which. 
SS. error type, number, pc, test, and unit, is not 
inhibited. 


H6 


—— ee eS 
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3.4.6 IDR Fleg (Inhibit DRepping of units) 


The IDR flag, when set, causes DRS to inhibit the dropping 
(deselection) of units by ea diagnostic. Diagnostics can 
deselect eo unit from the test process if an error threshold 
is reached or if e serious error is detected. This flag 
allows you to keep the unit selected, usually for the 
purposes of tracing the error. 


3.4.7 IER Fleg (Inhibit Error Reports) 


The IER flag, when set, causes DRS to inhibit all error 
reporting to the console terminal. While in effect, no 
cansegee ere sent to the operator except system error 
reports such as ILL INT Cillegel interrupt) and end-of-pass 
reports. This feature is aareeey used in conjunction with 
error looping. It speeds up the test process and, in the 
cease of hard copy terminals, saves paper. 


3.4.8 ISR Fleg (Inhibit Stetisticel Reports) 


The ISR flag, when set, causes DRS to inhibit the printing 
of statistics by the diagnostic. This is an optional 
feature and not el] diagnostics support statistics. Consult 
specific diagnostic documentation to determine whether or 
not e diagnostic has this feature. 


3.4.9 IXE Fleg (Inhibit eXtended Errors) 


The IXE flag. when set, causes DRS to inhibit the extended 
error reporting only. The error reports produced by the 
PRINTX call are inhibited. The error message and basic 
reports are printed. 


3.4.10 LOE Fleg (Loop On Error) 


The LOE flag, when set, enables DRS error looping. When 
error looping is in effect, DRS causes the di stic to 
continually re-execute the code that detected the error. 
Looping remains in effect even if the symptoms that prompted 
the error report disappear. This allows for looping on 


OS 


16 


A A OO GROOT OO  — -_—- 
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intermittent errors. To stop the looping, you must type 
CTRL-C (C) to return DRS to command aan . 


3.4.11 LOT Fleg (Leop On Test) 


The LOT flag, when set, causes DRS to continually execute 
the test(s) specified with the TEST switch. The initialize 
and end-of-pass code ere not executed as in normel operation 
however. 


3.4.12 PNT Fleg (Print Number of Test) 


The PNT flag, when set, causes DRS to print the number of 
the test being executed. 


3.4.13 PRI Fleg (PRInter) 


The PRI flag, when set, causes DRS to redirect all messages 
to ea line printer. This does not apply to command prompts. 


3.4.14 UAM Flag (UnAttended Mode) 


The UAM flag, when set, prevents the use of manual 
intervention during testing. Menual intervention assumes 
thet an rator is present to undertake any necessary 
action. The use of this flag allows the operator to start. 
the diagnostic and let it run unattended. When this flag is 
in effect, some testing will be inhibited. Refer to 
 pogps. diagnostic documentation for a description of VAM 
flag effects in specific cases. 


3.5 Teble Building 


DRS uses hardware tables for unit information (such as 
veprecer addresses, drive numbers or interrupt priority). 
Tables ere also used for eas operational 
information (such as what date patterns to use for testing 
or whether or not to do read-only testing). The specific 
information varies from diagnostic to diagnostic, so this 


JE 


——— ee 


-_--_— —-———- — 
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section only seeks to provide you with some background 
information on these tables. 


These tables must be constructed. They are constructed in 
three ways. 


1. The di tic is typicels released (distributed) 
with only a “template” table for hardware data. 
This template contains default values for hardware 
information in some cases. In any event, you must 
build the actual tables. This is most often done 
by starting the diagnostic with the start and 
specifying the hardware date as requested by the 


diagnostic. 


2. The table may also be “prebuilt" using the SETUP 
utility (Chapter 6). TUP is an XXDP utility 
re thet allows the user to build tables 
wit actually running the diagnostic. The 
tebles ere stored with the diagnostic on the XXDP 
medium and are brought into memory with the 
diagnostic et runtime. The user may then initiate 
diagnostic operation without building tables. 


3. The tables may have been built by the diagnostic 
programmer. these tables ere already a part of the 


program image and can eas they ere or 
chakead after a START command. 


The operational table, which is called the software (SW) 

table, may not be present in all diagnostics. If it is not 
present, you are not asked if you wish to change it. This 
is en actual storage area that has default data coded into 


'c. 
All teble-related questions have the same format: 
Question (type) [default] ? 


The question may be something like “DRIVE NUMBER”. The type 
iS @ one gharecter code for the type of enswer desired, 
enclosed in parenthesis. The possible types and codes ere: 
0 for octal, D for decimal, 6 for oieery. 5 for ASCII and L 
for logical (Y or N). The question mark indicates that DRS 
is re to accept the answer. If the answer is 
unaccepteble for any reason, an error message will be typed 
end you ere asked for the information again. 


When you enswer the hardware questions, you are building 


Ee) = 


IK6 


—-_—- ee ee ee 


——~ wee 
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entries in ea teble that describes the devices under test. 
The simplest way to build this table is _to answer all 
questions for each unit to be tested. If you have a 
multiplexed device such as a mass storage controller with 
several drives or ae communication device with several lines, 
this becomes tedious since most of the answers are 
repetitious. 


To illustrate a more efficient method, suppose meses Gy are 
oem oe My Fictional device, the XY11. his device 
consists of e@ control 1 module with eight — (sub-devices) 
attached to it. These units are described by the octel 
— 0 through 7. There is one hardware parameter that 
ay among units called the "Q-factor". This Q-factor 
or 1. Below is a simple way to build a table for 
one evaa thy eight units. The underlined portions are 


typed by 
UNITS (02 2 & 


mae Bs 
Bre 
ow ~ ape 


- EEE EE 


eC eS ee 
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Fs, 

- 6 
-EA 4 3 -" 

I 

$ a 2 160000 

? 2°? 

Re, 


Notice that the default value for the Q-factor changes when 
®@ non-default response is given. Be careful when specifying 
multiple units! 


As you can see from the above example, the hardware 
peremeters do not vary significantly from unit to unit. The 
procedure shown is not very efficient. The runtime services 
can take multiple unit specifications however. Let's build 
the same table using the multiple specification feature. 


VNIIS (022 8 


i APR 2, 1 
I 

ra ATE “Bye 
I 

i MUS “gh, 


As you can see in the above dialogue, the runtime services 
will build as many entries as it can with the information 
given in any one pass through the questions. In the first 
pass, two entries ere built since two sub-devices and 
Q-factors were specified. The services assume that the csr 
address is 160000 for both since it was sene*t ior only once. 
In the second pass, four entries were built. This is 
because four sub-devices were specified. The "-" construct 
tells the runtime services to_increment the data from the 
first number to the second. In this case, sub-devices 2, 3, 
4 and 5 were specified. (If the sub-device were specified 
by addresses, the increment would be by 2 since addresses 


—————e ee me 
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must be on an even boundary.) The csr addresses 

Q-factors for the four entries are assumed to be *760000 and 
0 respectively since they were only cified once. The 
lest two units are specified in the third pass. 


The whole agg could have been accomplished in one pass 
es shown below 


UNITS (022 8 


i AiR “2, 3 2, 60900 
fo 1b. 033 


a ou can see from this example, null replies (commas 
enclosing a null field) tell the runtime services to repeat 
the last reply. 


a <a ee 


SEQ 0078 


B7 


CHAPTER 4 
UPDAT UTILITY 


UPDAT is a file manipulation utility program used for 
building XXDP media, copying files from one medium to 
another, deleting files from ea medium aed) Fring files and 
other functions. The component name for UPDAT 1s “CHUP2?? 
UPDAT UTIL”, but for the benefit of the user, the program is 
released under its common name: UPDAT 


4.1 Description 


UPDAT runs im the lower part of memory and occupies about 6K 
words. It uses the runtime monitor for interfacing to the 
operator and loading the retrievable device drivers thet it 
uses to accomplish device related functions. Since AT 
requires these device drivers, the drivers you intend to use 
must be resident on the system medium and the system med: um 
must be evei lable (on-line) throughout your use of UPDAT. 
Tmere is one exception that is explained later in this 
chapter ® conjunction with the DRIVER command. 


4.1.1 Sterting WDAT 
"o stert UPDAT, type: 
R UPDA’ 
Jner the program hes peer successfully loaded by the 
mor tor, t types %ts "ame and = restert address and then 


tyoes tne prompt, © to tell you that it it is ready to 
accept commands. 


——— —_— -—_—-- 
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4.1.2 Commands Functions 
This section describes the command categories and then gives 
® detailed description of each command. UPDAT commands can 
be d: vided into the following categories: 
o File manipulation commands 
File modification commands 
New medium creation commands 
Miscellaneous commands 
Return to monitor commands 
o Print commands 


Tre following sections describe the commands in each 
category. 


4.1.2.1 File Menipuletion Coamends 


The file manipulation commands are used to maintain XXDP 
medis. Files can be transferred from medium to medium, 
deleted from e medium or renamed. A directory. or list. of 
files on a medium may be obtained. The file manipulation 


commends ere: 
DIR ive directory of specified medium 
PIP rensfer e file or files 
FILE transfer ea file or files 
DEL delete os file or files 


rename a file 


4.1.2.2 File Medificetion 


kn ‘mportent function of UPDAT is the modification of binary 
f[les. When @ diagnostic program is found to have oe 
geficiency. one of the corrective measures taken is to issue 
e DEPS or “petch order”. This is ea temporary change to e 
relessed program. 


Pe” “Ss one of the means of implementing these temporary 


C/ 


SEQ 0080 
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remedies. The program in question is loaded from an XXDP 
medium into en eres in memory celled the program buffer. 
Tris eres lies in the physical eatery spece between the 
monitor end UPDAT end its size is determined by the amount 
of memory in the system. The size is equal to the — 
size minus BK words, but no larger than 20K words. 

progres imege., now resident in memory, may be modified and 
ther put beck onte an XXDP medium ("dumped"). The transfer 
aniore oe sane loed imege size may also be altered by the user 
8 ‘Ss time. 


The next seven commends relete to this function of UPDAT. 

In the descri ipt ene of these commends, locations within a 
em thet hes been loaded into the program buffer ere 
referred to es “virtual locations” since their addresses are 

relative to the first physicel location in the program 
buffer and not the first Ly memory location as would 
be the case if the program been loaded by the monitor. 


The locetion. addresses ~— in @ DEPO et ga 
ineering Patch Order treated es virtual when using 
JPOAT. For exemple, if the DEPO says to modi ila referee 


og thet will be the Ra. location you will refer to in 
he MOD command loaded b 


; af woh Oy Sg has been 
pa Pi. however, 1002" would en absolute ~ conn % 
memory. not a relative location in the progrem buffer. 


The file modification process lies to image (BIC or BIN) 
files only. The process, briefly. consists of the following 


steps: 
1. Load the file into the program buffer with the LOAD 


command. 
2. Ch the size of the i . if necessary, with 
See RICORE ana LOCORE commands. 


a pang? Mn. es of the desired location(s) with 
the comm 


4. Modify the transfer address, if desired, with the 
XFR command. 


5S. Write the image onto media with the DUMP command. 


D/ 


—— + - _ s 


ee ~~ = 
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The file modification commands are: 


CLR clear UPDAT program buffer 
LOAD load @ program 

modify file i in memory 
XFR set transfer $s 


HICORE set upper memory limit for dump 
LOCORE set lower memory limit for dump 
DUMP dum @ program image 


4.1.2.3 Mee Medium Creation 
The folowing commands are used to create new XXDP media. 
on build process is described in detail in Appendix E of 
is . 
The new medium creation commands are: 
ZERO initialize ea medium 
CREATE save @ monitor on a disk or tape 
Cory copy entire medium 


4.1.2.4 Miecellenecus Coanends 
The following are miscellaneous commands: 


ASG essign e logical name to o device 
DO execute an indirect command file 
READ read a file to check validity 


EOT write logical end-of-tape mark on a tape 
DRIVER load e device driver 


4.1.2.5 Returning to Monitor Commands 


The following two commands allow you to return control to 
the monitor: 


BOOT bootstrap a device : 
EYIT return control to the runtime monitor 


ge 


—_———— ee 
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4.1.2.6 Printing Commends 


rine ere two commands to output textual information from 
:42es. 


PRINT print a file on the line printer 
TYPE type a file on the console terminal 


4.2 Conmends 


The detailed descriptions of UPDAT commands follow, in 
alphabetical order. 


F7 


—_——_ —_—_—_— —_ * 
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4.2.1 ASG Commend 

The assign command is used to assign ea logical unit number 
to ea device. The device can then referenced by this 
number in ensuing UPDAT commands. 

The format of the command is: 


ASG dev:=n 


dev - device to be assigned 
n - logicel unit number (0-7) 


The primary use for the assign command is to facilitate the 
poo od DO command and indirect command files (see next 
section). 


Example of assign command: 
ASG DYO:=0 


PIP 0:=DY1:«.CCC 
FILE 0:=MMO:FILE.NEW 


G/ 


oe —— a: A rrr a ATi A a ie 
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4.2.2 BOOT Coamand 


The bootstrap command is used to start the monitor in the. 
seme manner as the hardware bootstrap. The purpose of this 
command is to allow you to boot a device other than the 
originel system device. The booted device is now the system 


device. 
The format of the command is: 
BOOT dev: 
The device must have ea bootable medium mounted. The boot 
process consists of loading the first physical block (boot 


block) into the first 256 (decimal) words of memory and 
starting execution at location 0. 


H7 


—— ee ee ae | 
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4.2.3 CLR Commend 

The clear command cleere the eet ~ outer into which 
programs ere loaded for modifice This command allows 
the user to assure that unused locations in @ program ere 
set to zero when the program image is dumped to a medium. 
The format of the command is: 


CLR 


17 


A 
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4.2.4 COPY Commend 


the onty command is used to copy a entire contents of one 
medium to another identical medium (e. 9. , ee to RPO6). 

The copy process can teke two forms. the first is an mage 
copy”. This is e block-for-block transfer es is nyery fas 
since all available memory is used as a buff 

device is @ bed block device, there is a anes thet a bad 
sector may be encountered during the copy process. In this 
cese the process is aborted. You then ave to use the 
second form, "file or". This is slower since only one 
block is transferred at a time. In —— cases, me former 
contents of _ medium are destroye There is no check for 
medium eo customer date cou d ;m lost. Be careful! 
There will be a warning ie as shown below. The copy 
will proceed only if eo ""Y"" is typed. 


The format of the command is: 
COPY devo: =devi: 


USER DATA ON devo WILL BE DESTROYED! 
PROCEED? (Y/N/CR=N) 


where devo and devi ere the output and input acon 


respectively. The two devices must be the same type 
devices must be online and the output device must 
wr i te-enabled. 


J/ 


i ly li 


—— oe ie 
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4.2.5 CREATE Commend 


The create command is used to place se bootable monitor on a 
medium. The command “places the ropriate secondary 
bootstrap on the boot block and places the monitor file on 

the medium in a predetermined section. Refer to headin E 
for details on building XXDP media. 


The medium need not be initialized with the zero command if 
the medium is already XXDP c tible. In this case onty 
the monitor and bootstrap on the medium prior to the CREATE 
operstion ere lost. All other files are preserved. 


The format of the create command is: 
CREATE dev: 


dev: is the device with the medium that is to be made 
bootable. The device must be online and 
write-enabled. The file XXDPSM. SYS. and the 
appropriate driver must be on the system device to 
build the monitor boot block image. 


KZ 
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4.2.6 DELETE Commend 


The DELETE command is used to remove a file, or files, from 
an XXDP medium. The actual process for deletion is to 
remove the file name from the directory and deallocate the 
physicel blocks used by the file. 


The format of the command is: 
DEL dev: ifile{/N)[/Q] 


dev - device where file resides; device is assumed to be 
online and write-enabled; there is no default 


ifile - file(s) to be deleted; file must be on dev've 
specified; extension must be specified (unless 
file has no extension); wildcards are accepted 


/N - inhibit printing of file names as they are deleted; 
if switch is not specified, names will be printed 


/Q - do not rewind before searching for file(s) (tape 
devices only); if switch is not specified, tape 
will be rewound prior to searching for each file 
to be deleted 


Examples of the delete command: 
DEL MMO:XYZ001.TXT/Q 


This command deletes the file named “XYZ001.TXT” on MMO. 
The search for the file begins at the point where the tape 
is currently itioned (the no rewind switch has been 
specified). error is reported if the device is not 
online and write-enabled or if the file does not exist. 


DEL *.0LD 


This command deletes all files on the system device with 
“OLD” extensions. An error is reported if the device is not 
online and write-enabled or if there are no files with "OLD" 


extensions. 


— = 


i 


ee en ee 


— see + 


SEQ 0089 


XXDP User's Guide -- UPDAT Page 4-12 


4.2.7 DIR Commend 


The DIR command is used to obtain a directory, or list, of 

files on a specified medium. You can specify where the 

directory is to go (console terminal, line printer or file) 
what form the directory is to take (long or short). 


The format of the command is: 
DIR ((devo: Jlofile)({/Q)=)(devi:]lifile){/Q)(/FJ(/B){[/L] 


devo - output device; default is console terminal unless 
ofile is specified or the “=" is used, in which 
case the device is default; device is assumed to 
be online and wri te-enabled 


ofile - name of file for directory (devo must be a | 
file-structured device); defeult is DIR.TXT; if a 
file already exists with the specified name, it is 
eutodeleted 


/Q - do not rewind output medium prior to beginning _ 
directory search for file with same name as ofile 
(for tape units only); rewind if switch not 
specified 

devi - device from which to take directory; system device 
—_— device is assumed to be online and 
re 


ifile - files to be listed in directory; wildcards are 
legal; default is . 


/Q - do not rewind input medium prior to starting | 
directory operation (tape devices only); rewind if 
switch not specified 


/F - give short form of directory; long form if switch not 
specified 

/B - list number of free blocks left on input medium 
(random access devices only) 

/L - send ery to ea line printer (parallel printers 
on 

There are senpice of both forms of the directory on page 16 

of this manuel. Examples of the directory command: 


DIR DYO:DISK.TXT=MMO:/Q@ - The directory of files on MMO 


—_ser, - EE 


rn 


SEQ 0090 
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DIR =DOR1:.BIN 


DIR 


DIR = 


DIR DYO:/F/L 


OO TV SE A A TT me 


N/ 


Page 4-13 


is written into a file called 
“DISK.TXT" on DYO. The tape 
is not rewound during the 
operation. 


A directory of all files with 
"BIN" extensions on DR1 is 
written into a file called 
"DIR. TXT" on the system 
device. 


- A directory of all files on 
the system device is typed at 
the console terminal. 


- A directory of all files on 
the system device is os into 
a file called "DIR.TXT" on the 
system device. Please take 
note of the effect of the. 

ls sign on the operation 
of the directory command. 


- A short form directory of all 
files on DYO is printed on the 
line printer. 


os —— ei tem 


SEQ 0091 
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4.2.6 00 Coamaend 


The do command is used to execute an indirect command file 
for UPDAT. This file is e text file that contains one or 
more commends executable by UPDAT with the exception of 
EXIT. You cen create ea command file that accomplishes some 
common task such es building new media. This saves time and 
effort since you need not enter each command by hand. 


The formet of tne command is: 
DO file.ext 


The specified file must be on the system device, therefore 
you cannot specify a device. 


There are two functions available in the indirect command 
file in addition to the normal set of UPDAT ¢ ——— 
First, any command line beginning with a semicolon (;) will 
be treated as a comment. [hat is, no action will be taken; 
the line is merely printed. Second, a command line 
beginning with e doller sign ($) will also be treated as a 
comment, except the processing of the command file will 
cease after the line is printed and resumed when a “Control 
Xx" is Suet (Control X is typed by depressing the X key 
while holding the CTRL down.) This second function can be 
used to stop activity while the operator performs some 
required task such as mounting e new medium or placing a 
device online. 

The file can be made more globel in scope by using logicel 
unit numbers instead of device names in the commands. The 
user can then assign logical unit numbers prior to using the 
indirect command file using the assign command. The example 
below illustrates the combined use of the two commands. 


Semple Command File: RMBLD.TXT 


FILE 1:20:¢.SYS 
FILE 1:=0:UPDAT.BIN 


The above file can be used to build the XXDP System on any 
PM02/3 using any other “XDP medium. (Note that the command 
line containing e “’" only is required to verify the zero 
process. See the zero command description.) The process for 
Going this is: 


SEQ 0092 


C8 
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R UPDAT 
ASG DR2 DR2: #1 
ASG MMO 


Do are. PxT 


The underlined portion of the above example is that typed by 
UPDAT. The remainder is typed by the user. 


- - SS NNR -_—-_-+ ~———_— = -_-_->- - = ——_——_— —— <a 


XXDP User's Guide -- UPDAT Page 4-16 


4.2.9 ORIVER Commend 


The driver command is used to explicitly loed a read/write 
device driver into memory. Up to two drivers may be loaded. 
If @ third driver is loaded, one of the drivers currently in 
memory will be lost. If a requested driver is already in 
memory, mo action is taken. 


The format of the command is: 
DRIVER driver[/driver] 
Driver is the two character device name (e.g.; DY = RX02). 


The list of supported devices and their names is in Appendix 
C. Note that two devices may be specified with one command. 


DRIVER DY:/DK: 


The purpose of the driver command is to allow a user to 
build XXDP media with limited resources. If the system 
device is required for building a new medium, the user can 
load the drivers required, remove the system medium, mount 
the new medium and build XXDP. 


D8 
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4.2.10 DUP Commend 


The dump commend is used to write the program inege in the 
program buffer into ea file on a medium. The image size is 
determined by the r and lower memory limits penteved by 
the HICORE end LOC commands. A trensfer address will be 
put into the file. This address can be examined end altered 


with the XFR command. 
The format of this command is: 
DUMP [dev: Jofile[/Q) 


dev - device to which file is to written; default is 
system device; device is assumed to online and 
wr i te-enabled 

ofile - file name for binary Files wi ldcerds ere not 
accepted; file with specified name must not 
already exist on device 


/Q - inhibit rewind before searching for logicel 
end-of-tape (tapes only) 
Examples of the dump command: 


DUMP DYO:ZRLAA1.BIN 
The program image is written to DYO and given the file name: 
‘RLAAL-BIN". . 
DUMP FILE3.BIC 


The image is written to the system device and given the 
specified name. 


E8 


—-_ —_—- ae © 


~—- _— 
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4.2.11 EOT Commend 


The EOT command is used to place a logical end-of-tape 
marker on e tape at the current position. Note, the tape is 
not . All files_after the current position will no 
longer be accessible. The marker consists of two 
consecutive tape marks. Any data beyond this point on the 


tape is lost. 
The format of the command is: 
EOT dev: 


The device must be a t unit. The system device, if a 
tape unit, is the default device. 


—————— 


FR 


—_—_——— 


SEQ 0096 
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4.2.12 EXIT Commend 


The exit command is used to return control to the runtime 
monitor. 


The format of the commend is: 
EXIT 


a 


re oe 


SEQ 0097 
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4.2.13 WICORE Commend 


The HICORE command is used to alter the address of the — 
highest virtual memory location that is transferred uring 8 
“dump” operation. The default location is printed after the 
LOAD commend. 


The format of this command is: 
HICORE 


The address of the highest virtual memory location to be 
used during a dump operation is printed. UPDAT waits for 
you to alter or accept the location. You can enter a new 
ocation by typing the octal address or accept the given 
location by typing e “carriage return”. This address must 
be above that of the lowest virtual location (low core) and 
paces Set of the top of the program buffer. 

xamples: 


HICORE 
40000 4 
De command changes the upper virtual location from 40000 to 


HICORE 
100000 (CR) 
This command allows the upper location to remain as 100000. 


SEQ 0098 


XXDP User's Guide -- UPDAT Page 4-21 


4.2.14 Leoed Commend 


The load command is used to load a binary file into memory 
for the purpose of modifying the program image. As the file 
is loaded, ea checksum is computed compared with a 
checksum stored with the file. 


The command format is: 
LOAD (devi: )ifile[{/N)[/Q]) 


devi - device from which to load the file; default is the 
a device; device is assumed to be online and 
re 


ifile - file to be loaded; no default accepted 


/N - inhibit printing of upper and lower memory limits and 
file name found Cif wildcard used) . 


/Q - inhibit rewind before searching for file (tapes only) 


Wildcards ere permitted in the file ification, but you 
should be careful when using them. The deta in the program 
buffer is the result of the overlays of each file found. 
The p em buffer is not cleared between loads and the 
unused locations for the last file loaded does not 
necessarily contain zero's for contents. The wildcard 
feature is really only useful for doing file sanity checks 
to verify thet files are not corrupted. 


After the load is successfully completed, UPDAT prints the 
transfer address and core limits (the lowest and highest 
virtual memory locations used by the progrem). These 
peremeters cen altered by the user as described in 
subsequent command descriptions. Example: 


LOAD DYO:PROG1.BIN 
XFR: 000001 CORE: 000000,020000 


This command is also used to load an XXDP monitor image into 
the program buffer. This must be done as part of the media 
build process. The section on New Medium Creation earlier 
in this chapter and Appendix E on Building XXDP describe 
this process. 


18 


—-— + -_- 


SEQ 0099 
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4.2.15 LOCORE Commend 

The LOCORE command is used to alter the address of the 
lowest virtual memory location that is transferred in a dump 
operation. The default location is printed after the load 
operation is completed. 


The format of this command is: 
LOCORE 

Examples: 
LOCORE 
000200 0 

This command modifies the low memory address to zero. 
LOCORE 
000000 20 

This command raises the low memory address to 20 (octal). 


- — 


-_—_—- 


SEQ 0100 
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4.2.16 Modify Command 


The modify command is used to alter the contents of one or 
more virtual memory locations in a program that has been 
loaded by UPDAT. 


The format of the command is: 
MOD nnnnnn 


nnnnnn is the octel address of the virtual memory location 
whose contents are to be modified. 


UPDAT responds by typing the address and the current 
contents. It then waits for you to either type new contents 
or accept the current contents by typing a "carriage 
return”. If you wish to modify, or examine, two or more 
consecutive virtual ary gable you type a “line feed" 
efter modifying each loce 


Examples: The following command modifies virtual memory 
location 2460: 

MOD 2460 

002460 770 771(CR) 
The Sellewieg commune examines but does not modify virtual 
location 12004: 

MOD 12004 

012004 012736(CR) 
The following command modifies two consecutive virtual 
memory locations (1220 and 1222). 


MOD 1220 
001220 120 167(LF) 
001222 120 1234(CR) 


KB 


—_—_—_—— ——— — ae ~ 


—— 
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4.2.17 PIP end FILE Coamends 


The PIP and FILE commands are used to transfer a single 
file, or multiple files, from one medium to another. There 
ere two differences between these commands: 


1. The FILE go allows autodeletion; the PIP 
command does 


2. The PIP command lets you specify an output file 
neme; the FILE ee does ned 


Autodeletion is simply the removal of a file from the output 
—— if it has the seme name and extension as the file 

being transferred. If you attempt to transfer a file when 
the name sereety exists on the output medium using the PIP 
command, the file is not deleted, the transfer does not 
occur and 8 warning anes is printed. If severe] files 
ere being transferred, only those that do not have names and 
extensions that match otrgety Suiting files on the output 
medium are transferred. If a FILE command is used, all 
files ere transferred rdkeoe of what files exist on the 
output medium and any files on the output medium that have 
names and extensions matching those of files —_ 
transferred ere deleted prior to the transfer. The operator 
is not notified of autodeletions. 


The PIP command may be used $e. rename a file during the 
transfer erotees since output file specifications are 
sllowed. The FILE command never accepts output file 
specifications and files will retain their names and 
extensions as they ere transferred. 


The format of these commands are: 


PIP [devo: J[ofile][/@Q]= wideyis st iditelt [/Q)(/N) 
FILE (devo: ]({/Q)=(devi:J]LifileJ[/Q)[/N) 


devo - output device: system device is default; device is 
assumed to be online and write-enabled 


ofile - file name for output file; wildcards are 
permitted, in which case the input files will be 
renamed to match the — gee ad (please 
refer to the examples be pow we o fault os if 
file already exists on ou device, erenefer 
will not occur; NOT USED ii vi FILE COMMAND 


/Q - do not rewind output medium prior to directory search 


~_ — - ht A 


me ; 


. —_—— en oe ee © 


SEQ 0102 
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for alre existing file (t devices only); 
rewind steer each file if phe not ape i Ties 


devi - input device; default is system device; device is 
assumed to be online and ready 


ifile - input file name; wildcards are permitted; default 
is .s file(s) specified must exist 


/Q - do not rewind before directory search for first file 
(tape devices only); rewind if switch is not 
specified 

/N - do not type name of each file as it is found; type 
each name if switch is not specified 


Examples of the PIP and FILE commands: 
PIP DYO:NEW.BIN=DR1:2Z2Z2ZZZ.BIN 


This command gepies the file “ZZZZZZ.BIN" from DR1 to 
“NEW.BIN” on DYO. The transfer does not occur if "NEW.BIN” 
elready exists on DYO. 


FILE DYO:=DR1:Z222ZZZ.BIN 


The file “ZZZZZZ.BIN is transferred from DR1 to DYO. It 
i og eo file of the same name on DYO if such a file 
exists. 


PIP =DDO:XMONCO.LIB 


The file “XMONCO.LIB” is transferred to the system device 
from DDO. The name is not changed. If " 0.LIB” already 
exists on the system device, you are given an error 
indication and the transfer does not occur. 


FILE =DDO:XMONCO.LIB 
This command has the same effect as the command in the 
previous example except that if “XMONCO” already exists on 
the system device, it is deleted prior to the transfer. 
PIP DU1:=DUO: 
All files om DUO are transferred to DU1. Any files that 


already exist on DUI ere not transferred and you are 
notified. The remaining files are transferred. 


. em ee ee ee oe er = a ee ee 


ee ee eee me 
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FILE DU1:=DU0: 


In this case all files on DUO will be copied to DUI, 
regerdless of what files already exist on DUL. This command 
provides @ convenient method of putting updated files onto 
an existing XXDP medium. 


PIP MMO:FILE??.+= 


All files on the system device will be transferred to MMO 
and RENAMED to have the characters “FILE” replace the first 
four cheracters of the original name. Be careful if you use 
wildcards on the output specification! 


SEQ 0104 


es - eee 


- — se me ae ees | eee Qe ees — 
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4.2.18 PRINT Coamend 

The print command is used to read textual information from a 
file and out it to e line printer. The file must contain 
text in ASCII f t. 

The format of the command is: 


PRINT (dev: Jifile[/Q) 


dev - device where file is located; default is system 
device; device must be online 


ifile - file to be printed; must exist and contain text 


/Q - do not rewind before qeerins for specified file 
(tape devices only); rewind will occur if switch 
is not specified 

Example: 


PRINT MM1:HELP.TXT/Q 
Tris command reads the file "HELP.TXT” from the tape on MM] 


and prints it on the line printer. The search for the file 
begins at the current tape location; no rewind occurs. 


SEQ 0105 
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4.2.19 READ Commend 
The read commend is used to cheek device and media 
integrity. Each block of the file specified in the command 


iS read into memory and a checksum is calculated 
conpyted checksum is compared to the checksum stored with 


the file. 
The format of the command is: 
READ idev: Jifile[/N)[/Q] 
dev - device from which file(s) are to be read;default is 
system device; device must be online 
ifile - file(s) to be read; wildcerds ere accepted 


/‘N - do not print name of each file as it is read 


/Q - do not rewind before gem for specified files 
(tape Gev ices only); rewind will occur if switch 


is not specified 


C9 


SEQ 0106 


XXDP User s Guide -- UPDAT Page 4-29 


4.2.20 RENAE Coamerd 


Tre reneme commend is used to change the file cification 

of an existing file without doing a transfer. The name of 
the f' le es recorded in the directory is changed, but there 
S$ "oO movement of dete. 


“ne format of the commend is: 
REN [ dev: ]newnem=[dev: Joldnam 


Ge. - device where file to be renamed exists; default is 
system device; device is essumed to be online and 
wr ite-enabled; device must de same for both input 


ano output 


newnam - new file specification; file with same — 
specification must not exist on device; wildcards 
ere accepted 


Oloram - current file specification; file must exist on 
Gev'ce; w ldcerds sre accepted 
Examples of the rename commend: 


FEN DYL:DIAG.OLD=DY1:DIAG.BIN 


mig qqanane reremes to the file DIAG.OLD on DX1 to 


“= “== . 


DY 


_—-s -_———_— © 


_——- =o. -_-—— - 


SEQ 0107 
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4.2.21 TYPE Command 
The type command is used to read textual information from a 
file and output it to the console terminal. The file must 
contain text in ASCII format. 
The format of the command is: 

TYPE [dev: Jifile[/Q) 


Gev - device where file is located; default is system 
device; device must be online 


ifile - file to be typed; must exist and contain text 


‘Q - do not rewind before searching for specified file 
(tape devices only); rewind will occur if switch 
is not specified 

Example: 


TYPE SYSTEM.CCC 


The file "“SYSTEM.CCC” is be read from the system device and 
printed on the console terminal. 


—- ee, RT — 


SEQ 0108 
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XXDP User's Guide -- UPDAT Page 4-31 


4.2.22 FR Commend 


The XFR command is used to modify . tognerer address in 
the progrem thet ‘hes been loaded. file created by the 
DUMP commend will have this nonlag.- address. This is 
address of the location to which control will be transferred 


when the progrem is sterted. 
After you enter this command, UPDAT prints the current 
transfer eddress. If you don't wish to alter the transfer 
address, you should ‘anedietely type a "“cerriage return”. 
The format of the command is: 

XFR 


Exemples of this command: The following command changes the 
transfer ederess from 200 (octel) to 1 1080 Coctal): 


XFR 
000200 001000 


The following command examines, but does not change, the 
trensfer address: 


XFR 
002000 CR > 


———_—_— ——_— 


SEQ 0109 


G9 
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4.2.23 ZERO Coamend 


The zero command initializes a medium by clearing the bit 
map (random eccess devices) or writing an end-of-tape mark 
(sequentiel eccess devices) and placing an empty directory 
on the medium. 


CAUTION: 


ell dete on the medium prior to a zero operation is 

ipretrievably lost after the operation. UPDAT makes 
no attempt to determine whet is on a medium and will 
destroy customer date. 


A warning is printed whenever this command is invoked, 
stating which device is involved. You must then verify that 
the zero operation is to take place. 


The format of the zero command is: 
ZERO dev: 


There is no default for the device. The device must be 
online and write-enabled. The following warning will be 
issued after the command is entered: 


USER DATA ON dev WILL BE DESTROYED! 
PROCEED? (Y/N/CR=N) 


Tne oniy answer thet will confirm the user's intent to cerry 
on is “Y". 


There will be an additional warning message if you specify 
the system device in the ZERO command. 


ZERO SYSTEM DEVICE 
YOU MAY NEED AN ADDITIONAL DBIVER 
PROCEED? (Y/N/CR=N) 


If you wish to proceed with the process, you must type a 
“Y", The meaning of the warning is that you must assure the 
presence in memory of two drivers, one for the system device 
and one for the device from which files will be moved to the 
new media in the system device. To assure that the 
necessery drivers are in memory, use the DRIVER command. 


-aGae cow —— ——-_ ae 


—. - _—_— 


SEQ 0110 
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4.3 Semple Modification 


The Following sample vite madi iaekion illustrates the use 
of UPDAT commands. It is based on the following patch for oa 


fictitious diagnostic oamed 2XXXB0. BIN: 
Location Old Contents New Contents 


1224 106701 240 
1226 177660 240 
1452 376 374 


a UPDAT dialogue used to accomplish this is shown below. 
he underlined gertien is that oes by UPDAT. (LF) and 
(On) refer to line feed and return 
~,R UPDAT 
CHYP2BO xXxXOP YPDAT VIILIIY 
RESTART ADDRESS: 002432 
LOAD ZXXXBO.BIN 


XER:; 000001 CORE: 000200. Qe7e3 
MOD 1224 

291886 199668 2aocee) 

MOD 1224 

981886 898849 cr) 

MOD 1452 

001452 000376 374(CR) 


MOD 1452 
001452 900374 (CR) 
DUMP ZXXXB1.BIN 
The user examines locations previously vo ath bina in order to 


verify the changes. The user also renames the file to 
reflect the patch level. 


H9 


ee 


SEQ 0111 


LY 


CHAPTER 5 
PATCH UTILITY 


The PATCH progres can be used to modify any binary formatted 
(.BIN or .BIC) file stored on an XXDP storage medium. It is 
an alternative to the LOAD-MOD-DUMP sequence of UPDAT. 


5.1 Description 
PATCH should be used in the following instances: 


1. You oo eon e file that is too large to be 
loaded into the memory space of your x em. This 
situation precludes the use of the LOAD-MOD-DUMP 
sequence of the update programs. 


2. You are modifying DEC/X11 runtime exercisers. (It 
is assumed thet reader is familiar with DEC/X11 
usage. If not, please read the DEC/X11 User Manual 
before attempting to use PATCH on this software. ) 
As these programs CANNOT be patched using the 
update programs, you must use this program ah ng 
wish to produce a permanently modified .BIN file 
for a DEC/X11 RTE. 


SSSSSSESSSSEEESSESESEESESESESSEESESEEEES 


Notice 
The DEC/X11 features have | 
not been fully implemented in 
DEC/X11 monitor. Please 
patch RTE‘'s with this 
es you would any other 
binary file. 
SESSSSSESSESEEESESEEEEEEESEESEREEEE 


—— - —_—_————<—— << -— eee 


— ——< -_—- = 


SEQ 0112 
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XXDP User's Guide -- PATCH Page 5-2 


5.1.1 Sterting PATCH 


Operation of this p am consists of two phases. The first 
is the building of ea table containing the modifications that 
will be made to the file in question. This table is 
referred to as the “input table”. You fill this table with 
the eddresses you wish to modify within the file, along with 
the desired contents of these addresses. This table my 
then be saved as a file and retrieved for later use. T 
second phase of operation is the combining of the 
information contained in the input table with the actual 
binary file to produce a new, modified file. The original 
file is not modified by the program. 


In order to load and start this program, you must type the 
following command to the XXDP monitor: 


.R PATCH 
This command ceuses the PATCH utility to be loaded into 
memory and begin executing. The program identifies itself 
with the message: 

CHUPA?? XXDP PATCH UTILITY 
The program then prompts for your input with the “* 


cheracter. At this point you can begin entering commands to 
the program. 


5.1.2 Commend Summery 
Tre valid commands for PATCH are: 


BOOT Boot specified device 

CLEAR Clear input table | 

EXIT Return to XXDP monitor 

GETM Load DEC/X11 MAP file 

GETP Load saved input teble 

KILL Delete address from input table 
MOD Enter address in input table 
PATCH Create patched file 

SAVP Save input table 


TYPE Print input table on terminal 


- —_ * — i 
~~ es | | eee oe - _————_— ei, la 


—_——— 7 


SEQ 0115 
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In order to patch a file with this program you must perform 
two operations: 


1. You must build an input table containing all of the 
addresses which you wish to wn iy within the file, 
slong with the contents you want these addresses to 
have. The input teble may have a maximum of fifty 
(50) of these entries. 


The commands you may use to build the input table 
ere: 


These commands ere described below. 


2. After you have completed the input table you must 
use the PATCH command to add the address : 
modifications within the i table to the file 
you want to patch. The PATCH command is described 

Ow. 


It is important to note that the file you are modifying is 
never completely loaded into memory. 


Kg 


oe ——— ~ 


SEQ 0114 


LY 
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5.2 PATCH Commends 
5.2.1 B800T 
The BOOT command boots the specified device. 
The format is: 
BOOT (dev: ]<CR> 
The default device is the system device. 


——_ o—ee - - 


Mo 
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5.2.2 CLEAR 
The CLEAR command clears the input table of ell entries. 
The command format is: 

CLEAR 


SEQ 0116 


-_— eee ee ee 


- -- ctr ene = 
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5.2.35 EXIT 
The EXIT command returns control to the XXDP monitor. 
The command format is: 

EXIT 


SEQ 0117 


—— —— = -—-e- 


TE ee Ee cee oS ere eee 
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5.2.4 Gem 

This command is used only when patchi bec sx yr 
exercisers. It retrieves e DEC/X11 " ad file of the 
specified filename from the ified device an loads it 
into memory (see section: 7g nape FILES” ). 


The command format is: 
GETM [dev: ]fi lnam.ext 
The default device is the system device. 


B10 


ee -_———e- ~ 


SEQ 0118 


C10 
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5.2.5 GTP 

The GETP command causes the input table to be loaded with 
the contents of a file thet was created using the "SAVP” 
command. Execution of this command causes any previous 
contents of the input table to be lost. 


The command format is: 
GETP [dev: )filnam.ext<CR> 


Tre default device is the system device. 


—oe — ee — —— 


D10 


$.2.6 MILL 
= Aa commend is used to delete an entry from the input 
ebie. 


Tre command format is: 
KILL <addr> 


-—_— ——— — 
_— . — =-_—— 


E10 
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$.2.7 "OD 


Tre MOD commend is used to enter an address end the desired 
new contents of that address into the input table. The MOD 
command has two modes of Spret ies, depending on whether you 
ere modifying ea DEC/X11 RTE or another type of binery file. 
moses ow 


These two ere described in the following sections. 


5.2.7.1 Binery (NON DEC/X11) Mode 


When used with binary files other than DEC/X11 RTE‘s, the 
format of the MOD command is: 


MOD addr 


where eddr is any valid 16-bit eddress. Leading zeros 

cen be om: tted. ’ 

After press cerriege return to conclude the command, the 
requested eddress is retyped. followed by e slesh. If this 
address hes not been previously entered in the input table, 
the slesh is followed by six dashes. (Because the file you 
wish to modify is not in memory, there is no way of roe te 
the current contents of the location you have ified.) if 
the address has been inserted into the input teble, the 
orev leuery entered contents of the address ere typed efter 

the s 





Example: 


In this exemple, the operator hes specified physical address 
123456 to be modified. The dashes indicate that this is the 
first time this eddress has been specified. 


Example: 


Biio8d7db0ee0 


In this cese en ectuel value appears after the slash. This 
indicates thet the operator had previously entered this 
address into the input table and had specified the new 
contents of the address to be 000240. 


kt ths pont you can type the value you wish to have loaded 


———_ <————_ << 


F10 


into this eddress. This velue can be ony octel number from 
0 to 177777. Leading zero's may be omitted. After entering 
the velve, you can type either a <CR> (cerri return) or a 
<LF> (line feed). A <CR> closes the tadle ys for 
this eddress end ceuses 8 prompt to be printed so the 
enother commend cen be typed. A <LF> closes the current 
teble entry and makes @ new entry for the next addressable 
memory location (i.e. <addr>-2). The new contents for this 


eddress can then be typed. 
Exemple: 


MOD 123456<CR> 
1234562------ 000207<CR> 


In _ the namie. the operator has specified that location 
123456 should contain 000207. The cerriage return closes 
the input table entry and causes ea prompt () to be printed. 


Example: 
9139407000280 000137<LF 
< > 
Bit Z=:::-: 051502<CR> 


In this cese the operator hes re-opened the table entry for 
address 11040, changed the contents to 000137, end typed ea 
<LF> to make @ table entry for location 11042. The dashes 
indicate this location had not been previously entered into 
the table. This location receives a contents of 51502, then 
oe <CR> is typed to close the table entry and cause 8 prompt 


5.2.7.2 O€C/X11 Mode 


When working with DEC/X11 files, the command has three 
ai fferent formats, as follows: 


MOD addr 

MOD MON modnem addr 

MOD opmod addr 

Form (1) of the MOD command is the same for DEC/X11 us as 


it is for mon-DEC/X11 usage (see previous section), with the 
exception that 18-bit addresses accepted. 


Forms (2) end (3) of the MOD command sllow the operator to 


—_— <—— -—-—— 


—_—<—<« - —— ee ee ee &§ 
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specifiy locations within ea DEC/X11 runtime exerciser (RTE) 

by tye: ing the neme of a monitor module or option module 
followed by - ol ll into thet module. These forms of the 

— = MAY e DEC/X11 “map” file has been 

retrie mE ONS ons.0f t M command (see section: 

CDEC ALI FILES”) 


Format (2) is used for modifying locations within monitor 
modules. An exemple of this format is: 


MOD MON KTERR 24<CR> 


The keyword MON is used to indicate that the module is in 

the moni tor enetion of the RTE. In this case the operator 
is specifyi location 24 relative to the beginning of the 
monitor module nemed "“KTERR". 


Format (3) is used for modifying locations py option 
modules of exercisers. is the name of the option 
module to be modified. The name hes five characters, the 
fifth cherecter being the copy number (the first copy is 0). 
An example of this formet is: 


MOD CPBJO 100<CR> 


The operator, by typing this command, is indicating that he 
wishes to modify location 100 relative to the beginning of 
the first copy of option module CPBU. 


In all three formats. after the <CR> is typed the actual 
physicel address being referenced will be tg followed by 
e slesh (/). If this address hes not been previously 
entered in the tes the slash will be followed by six 

s (------ ). If the address has alre been entered in 
the rout table, the previously © ontents of the 
address will be printed after the slash 


Exemple: 
MOD 012546<CR> 
12546 


In the exemple, the operator hes specified physical address 
12546 to be modified. The address is retyped, followed b 2 
slesh. The dashes indicate that this is first time t 
address has been specified for modification. 


Example: 


. — = _——— 


G10 


—— — — ee « 


— —— eS 


SEQ 0123 
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MOD MON KTERR 10 <CR> 
0071262000240 


In this case the operator has specified an address within 
the monitor section of the RTE and has done so by using e 
module neme. Notice that the program determines the actual 
physicel eddress represented by the command string arguments 
and prints thet eddress. Here an actual value appears after 
the slash. This indicates that the operator had previously 
entered this address into the input table and specified new 
contents of 000240. 


At this point you can type the value you wish to have loaded 
into the specified address. This value can be any octe 
number from 0 to 177777. —— zeros can be omitted. - 
After entering the value you wi you can type either a 
cerriage return or a line feed. A <CR> closes the current 
table entry and causes a prompt () to be printed so that you 
can then type another commend. A <LF> closes the current 
table entry and makes a new entry for the next addressable 
memory word (i.e., <addr>-2>. You can then type new 
contents for the address. 


Exemple: 


MOD 012546<CR> 

125462------ 000207<CR> 
In the example, the operator has specified that location 
12546 euae contain 000207. The <CR> closes the input 


table entry and causes a prompt to be printed. 


Example: 


MON KTERR 10<CR> 


Gozeesooues0 137 


In this case the operator modified the contents of the 
location 7126 so it will be 000137 (he had previously 
specified that this address should contain 240). He then 
typed a <LF> to close the table entry for address 7126 and 
to create a table entry for location 7130. The dashes 
indicate thet this location had not been previously entered 
in the table. This location received a contents of 51502 
and ea <CR> was typed to close the table entry and cause of 
prompt to be typed. 


H10 


_——~——- — 


SEQ 0124 
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5.2.6 PATCH 


After the device address modifications have been entered in 
the input teble, ea new output file containing these 
modifications cen be produced with the use of the PATCH 
command. This command reads the specified input file, adds 
the address modifications contained in the input table, and 
builds ea new output file having the specified file name. 


The formet of the command is: 
PATCH (dev: ]fi lnem.ext=[dev: ])fi lnam.ext<CR> 


The default device (input end output) is the system device. 
The input file and the input teble are unaffected by the 
execution of this command. 


An exemple command string is: 

PATCH DY1:SAMPL2.BIN=DYO: SAMPL1.BIN<CR> 
This command takes the file SAMPL1.BIN located on device 
DYO, combines it with the address modifications in the input 


table, and produces ea new file on device DY1 called 
SAMPL2.BIN. 


After you press the cerriage return to conclude the command, 
the fol lowing instruction is printed: 


IF THIS IS DECX11 TYPE THE MONITOR TYPE. ELSE JUST <CR> 
If you are patching any file which is not ea DEC/X11 runtime 


exerciser, then t e <CR>. If this response is typed, the 
roe file. When 


program begins construction of the i F 
execution is completed, the message “ " is printed, 
followed by e prompt. 


If you ere patching ea DEC/X11 runtime exerciser (RTE), you 

aust respond to the printed question py telling the program 
the type of monitor contained in the RIE. There are three 

methods for determining the monitor type of the RTE: 


1. Rum the DEC/X11 configurator/linker program and 
type the configuration file for this RTE, if it 
exists. 


1 


I10 


SEQ 0125 
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2. Run the DEC/X11 configurator/linker program and 
type the MAP file for this RTE, if it exists. The 
monitor type appears at the top of the listing. 


3. Run the RTE. The monitor type is printed at 


If the monitor of the RTE is one that does not support 

memory management, the program now begins building the new 
output file. When this process is on ache the mess 

. “ is printed on the terminal, followed by e@ prompt. 

If, = ig ty — the specified yah monitor type is 
one tha support memory management, program now — 
checks to see if a MAP file has been loaded into memory with 
the GETM command. If there is no MAP file in memory, 
following instruction is typed: 


TYPE MODQ@ ADDRESS: 


In order to determine this address, you must look at a 
listing of an app iete MAP file (see DEC/X11 MAP Files). 
The s 1 MOD@ is located within the monitor € 
“CONFIG”, so just find the le name “CONFIG” on the 


1 ound 
next to the symbol “MODQ" is the address which must be t 
in response to the question. If a MAP file wes previously 
loaded into memory using the GETM command, the program 
automatically finds this address and thus does not ask the 


question. 
Next, the following message is printed: 


IF MODIFYING OPTION MODULES, TYPE LOWEST MODULE 
ADDRESS, ELSE JUST <CR> 


If you are modifying only the monitor section of the runtime 
exerciser, the proper response to this message is to simply 
type a <CR>. If you are patching both the monitor area and 
one or more option modules, or i you ere patching only 
option modules, you must now type the address of the first 
option module that wes linked into the runtime exerciser. 
This eddress can be obtained in two ways: 


1. If you have a MAP file dieting for the proper 
monitor type (see “DEC/X11 FILES"), find the 
first occurance of an option module name on the 
ciecing and use the physical address associated 
with that option module. The option modules are 


J10 


SEQ 0126 


K10 
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located at the end of the listing. The eye ical 
address of each module is printed next to the 
module name, under the heading “PH ADDR". 


2. Before running the PATCH program, you can load and 
run the RTE that_you intend to patch, then type a 
"MAP“ command. This command causes the starting 
addresses of all option modules to be printed. For 
each option module, look for the address labelled 
“PA:". Find the physicel address which is lowest 
(not necessarily the first one printed! ). 


After the typing of ea <CR> the program will commence 
construction o° the output file. execution has been 
completed the mssage “DONE” will be printed, followed by a 


prompt. 


_£_ AL LLG LLL EO 


SEQ 0127 
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5.2.9 SAVP 

This command causes the contents of the input table to be 
saved as o file with the specified filename on the specified 
device. The command does not cause any alteration to the 
input table contents. 


The command format is: 
SAVP [dev:]f: lnam.ext<CR> 
The default device is the system device. 


10 


SEQ 0128 


~_ oe oe eee 
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5.2.10 TYPE 


The TYPE command causes the contents of the input table to 
be listed on the system terminal. 


The command format is: 
TYPE 


———— 


SEQ 0129 


—— a ee | ee oe ee Oe oF 
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5.3 DEC/X11 MAP Files 


In order to utilize the full capabilities of the MOD command 
aah geeitying DEC/X11 runtime exercisers, you must have a 
ile. 


The MAP file is produced by the DEC/X11 configurator/linker. 
It is the symbol teble which is generated at link time and 
saved usi _SAVM command. (Please refer to the DEC/X11 
User Manual.) Without the MAP file the MOD command will only 
ony eg oe addresses as arguments, but if a MAP file 
has etched using the GETM command, the MOD command 
will accept module names (both monitor and option module 
nemes) es arguments. 


If yeu ere going to modify the option modules of a 
perticuler runtime exerciser, and if you wish to be able to 
t the option module name and an offset value when using 

the command, then ~ must use the MAP “oa Ganerened during 
the linking of thet particuler RTE because the number and 
order of option modules in any RTE is unique. If yey 
don't have the proper MAP file you must manually calculate 
the physicel address of the option module's relative address 
and type thet value as the command's argument. 


On the other hand, for any given monitor type (A, B, C, 
etc.), the monitor modules are always linked in the same 
sequence. This implies that if you are modifying the 
monitor section of an RTE and wish to t the monitor 
module name plus an offset when using the MOD command, you 
need not have the MAP file for the particular RTE you ere 
modifying. Any MAP file for the greper monitor type will 
do. For example, if you are modifying the monitor ereea of 
an RTE of e monitor type C, you may use any MAP file which 
aAS rated when linking any RTE having monitor type C. 
Similerly, the address of 2 is also same for every 
monitor of the same type. so if the PATCH command prompts 
you for the address of MOD@, you may look at any map listing 
of the proper monitor type to obtain the address. 


It is important to remember that when a new release of the 
DEC/X11 monitor library is issued, all MAP files generated 
from the previous release of the library become invalid. 
They may not be used when gee Ape generated with the 
new library. New MAP files must produced. 


SEQ 0130 


Bil 
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$.3.2 Suggested DEC/X11 Applicetion 


Wren a DEPO is issued for ea DEC/X11 monitor module, the 

patch must be added to every runtime exerciser that is 
rated containing that module (depending on the monitor 

ype). If ere in an environment in which you build many 
RTE‘s ( ecturing., for exemple), it is eygqnenes that you 
build end save an input table for every monitor type. These 
seved tebles can be added to and gy tee le @ new 
DEPO is issued. oe RTE is built with t 
conf iguretor/linker, simply run this program, get the input 
table for the proper monitor type, add to the table any ; 
modifications that must be made to the option modules (using 
the MAP file if you wish) and then execute the PATCH 
command. 


Cil 


CHAPTER 6 
SETUP UTILITY 


SETUP is an XXDP utility that elts you build the hardware 
and software tables for a diagnostic prior to running the 
Sreppeat ic and store the tables with the di tic. 

SETUP has the same memory requirements as DRS: 5.75K words. 
The minimum size system that can be used is 28K words. 


6.1 Sterting SETUP 

To rum SETUP, use the XXDP run command. Below is an example of 
starting SETUP for use im building XXDP environment diagnostics. 
The underlined portions are typed by the system. 


a? SETUP 
* 


SETUP is now ready to sccept commands. 


6.2 Coamaends 
Tre following are the SETUP commands: 
SETUP build tables for specified diagnostic 
LIST type = list of DRS diagnostics on e medium 


E¥I* return control to XXDP 


-——_—— ee ee ee 


SEQ 0132 


Dil 
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6.2.1 LIST 


The LIST commend is used to obtein a list of all 
DRS-compet ible diagnostics on ea medium. 


Tre formet of the commend is: 
LIST (dev: ][file.ext] 
Gev - device to search for DRS-compatible files; default 
iS the system device 


file.ext - file(s) to search; extension must be BIN or 
IC; wildcard specifications are accepted; default 


is “.B1I?" 
6.2.2 SET? 
Tre SETUP command ceuses the specified di tic to 
loaded into memory. SETUP then erocessce he table building 


code in the diagnostic. You go through Ae. same process 
thet occurs when actually running the diagnostic and issuing 
@ START command 


Tre format of the command is: 
SETUP [devo: Jofile=[devi:Jifile 


Gevo - device to which file is to be written; default is 
system device; device must be on-line 


ofile - name of file for the d tic thet has been 
SETUP °uITH .BIN OR “afc XTENSION 


Gev' - device from which file is to be read; default is 
system device; device must be on-line 


ifile - coreo” file for the diagnostic that is to be 
‘ou can give the output file the same name as the input 
file. you get e message that warns sep ines the — 
acc ‘dental "lees of the or:ginal file. The message is: 
DELETE ifile? (Y/N/CRe¥) 


z* you type a “’” or no answer st all, the input file 


SEQ 0133 


Eli 
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"ifile’ is deleted after the SETUP process and the new file 
is then written. 


Fil 


CHAPTER 7 
XTECO UTILITY 


The XTECO (pronounced “ex-tee-co") utility is used to create 
and edit oageet fs text files. Text files contain ASCII date 
representing valid text. Valid text consists of ell 
printing characters, teb. carriage return, line feed and 
form feed. The principal text files in XXDP ere batch 
control (chain) files. XTECO is e simple editor, a limited 
subset of the TECO character editor supported by most of 
DEC's opereting systems. The commands ere few and simple, 
but edequate for the task. 


7.1 Oescription 


Before describing the commands in detail, let's look at some 
besic XTECO concepts. To XTECO, a text file contains one 
long string of characters sort of like beads on 8 ety ing, 

It processes the file one cherecter et atime. The utilit 
can only have e certain number characters in memory, so only 
@ segnent of the string can be worked with any given time. 
There ere specie] cheracters (cerriege return and line feed) 
that ect es signels to XTECO to tell it when one line of 
text ends end enother begins. This allows the editor to 
menipulete lines of text es well es characters. The editor 
keeps track of where it is on the string with e pointer. 
This pointer is manipulated by the various commands and is 
used by XTECO to locate where new text is to be placed and 
old text removed or modified. This potsaet may be moved 
beck end forth over the portion of the string in memory at 
the time, but cannot go backwards into the portion of the 
string elready processed and pleced into the new file. Thus 
you need to understand two bas'c concepts: text as a string 
of characters end 8 pointer to locate the editor on that 
string. 


SEQ 0135 
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As previously mentioned, only @ certain segment of a text 
file may reside in memory at any given time. XTECO 
processes files by reading e segment from the input file 
into memory, doing any edit functions on that segment (as 
directed by the user) and then writing the segment into the 
output file. This process continues until the entire input 
file hes been acted upon. In the case of the “TECO” command 
(see next section) where the input end output file may have 
the seme name and reside on the seme medium, XTECO creates e 
temporary output file which replaces the input file after 
the edit process ‘s complete. 


Gli 


SEQ 0136 
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7.1.1 Sterting the Edit Process 


The first thing e user must do after starting XTECO is to 
initiate the process of editing text. (XTECU is started by 
typing “R XTECO” in response to the XXDP monitor prompt. ) 
There are three commands to do this. 


TEXT - used to create a new file 
TECO - used to modify a file 
EDIT - used to modify a file 


Each of these commands puts XTECO into what is called “edit 

“, While in this mode, text informstion can be created, 
deleted or modified. There is one difference between the 
EDIT and TECO commands. The TECO command can be used with 
random-access devices (i.e., disks) only and the input file 
name is all that is required. The output file name ias the 
seme as that of the input file. An output file is created 
during the edit process and is used to replace the input 
file after completion of the edit process. The EDIT command 
can be used with any type of device, but the i and 
output devices must be different (either different device 
types or different units of the same type). 


The formats of these commands are: 


TEXT [devo: Jofile 
TECO va HAS 
EDIT [devo: Jofile=[devi:]ifile 


where, 
devo - output device where the new file is to be stored 


ofile - name of file for output ee 
devi - input device from which old file is to read 


ifile - name of input file 
After one of these three commands is executed, XTECO is 


in “edit mode” and issues a double quotation mark ('“') as a 
command prompt instead of an asterisk. 


Hid 


Cl = SS ee 


SEQ 0137 
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7.1.2 Commend Summery 


The thirteen commands available in edit mode are listed by 
type of function in the following table: 


Edit Mode Commends 


Pointer Location — : 
L - move the pointer line by line 
C - move the pointer cheracter by character 
J - move the pointer to the beginning of text 
ZJ - move the pointer to the end of text 


Search 
S - search for specified string in text now in memory 
N - search for specified string in remainder of text file 


Modify/Display Text 


T - — text 
D - delete character(s) 
K - delete line(s) 
I - insert text 

A - append text to that currently in memory 


Terminating Edit Mode 
EX - exit edit mode 


All commands are terminated by two eltmode (escape) 
cheracters. The altmode (escape) key is usually the 
left-uppermost key om DEC terminals. The altmode (escape) 
cheracter is echoed on the terminal as "$" and is 
represented that way in examples in this chapter. 


—_—+— —— me — _- ~_—-—--——- 


J11 
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7.2 Commande 


The following sections explain each edit mode command in 
detail. Following these explanations, there is a sample 
edit session. 


In examples where it is important to display the position of 
the pointer, @ caret, "ft", is used to designate the position 
within the sample text. This is for illustrative purposes 

only! This character is not used for this purpose in actual 


operation. 
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7.2.1 A Commend 


The A command is used to increase the amount of text stored 
in memory. This is done by reading the next section of text 
from the input file and “appending” it to the text already 
in core. You may append as many sections of text as memory 
size limits allow. 


The format of the command is: 
A$$ 


The combined sections of text in memory are treated as a 
single section by the previously described commands. 


K11 


—————— ee ee --. 
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7.2.2 C Commend 


The C command is used to move the pointer on a ; 
cherecter-by-character basis. Lines are not recognized by 
this command; the cerriage return/line feed sequence is 
treated es two characters. The pointer may be moved forward 
or beckward eny number of characters within the text 
currently stored in memory. 


The format of the command is: 
([nJ)C$$ 


where m is an optional argument that specifies the direction 
to move and the number of characters encompassed by the 
move. It is a decimal number that is positive for forward 
motion and negative for backward motion. If it is not 
specified, “1" is assumed. 


Following are examples of the C command. The caret, “t" 
indicates the position of the pointer after execution of 
each commend. XTECO's prompt ('"') is also shown in the 


examples. 
Command Text in Memory 
-- ;NEXT COMMAND WILL TtEST RPO6 
;ALL ERRORS WILL BE REPORTED 
"C$$ sNEXT COMMAND WILL TETST RPO6 
;ALL ERRORS WIL BE REPORTED 
".3C$$ ;NEXT COMMAND WILL? TEST RPO6 
;ALL ERRORS WILL BE REPORTED 
“10C$$ sNEXT COMMAND WILL TEST RPO6T 
;ALL ERRORS WILL BE REPORTED 
"3C$$ sNEXT COMMAND WILL TEST RPO6 


;tALL ERRORS WILL BE REPORTED 
Please note the effect of the cerri return/line feed 


sequence on the execution of the last command in the example 
above. The sequence counts as TWO characters. 


- ee ee 


Lil 


ee = a a + 


-—_— -—_— — ———— — - 
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7.2.3 0 Commend 


The D command is used to delete characters from the text in 
memory. Any number of characters, either presensiss or 
following the current pointer position, may be delete 


The format of the command is: 
([n]D$$ 


where mn is an optional argument that specifies the number of 
cherecters to be deleted. It is ea decimal number that is 
positive if the characters follow the current inter 
position and is negative if they preceed it. If it is not 
specified, “1" is assumed. 


Following ere examples of the D command. The caret, “t", 
indicates the position of the pointer. XTECO's prompt ('"“') 
is elso shown in the examples. 


Command Text in Memory 

-- ;COMTMENT LINE IN BATCH CONTROL FILE 
“4D$$ ;COMt LINE IN BATCH CONTROL FILE 
"-3D$$ ;t LINE IN BATCH CONTROL FILE 


“D$$ ;tLINE IN BATCH CONTROL FILE 


SEQ 0142 


ee ee te ee eee -* 


— — —eeee ~ee er ere ee e eeee e 


~ ee ee we ee ee ee ee —_— a ee - ee ee ee | | ee ee 
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7.2.4 EX Commend 


The EX command is_used when all editting operations have 
been completed. "the output file is closed. If the edit 
session was initiated using the TECO command, the input file 
is renamed with ea .BAK extension and the output file vias Se 

iven the original nue of the input file ECO wil 

onger be in edit mode as signified by the switching ae the 
re fe beck to an asterisk (”") from a double 
quote ‘nme 


The format of the command is: 
EXx$$ 


SEQ 0143 


— ee ae Oe ee ee eee ee oe ee 
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7.2.5 I Command 


The I command is used to insert new text. The text is 
inserted efter the current pointer position. The pointer 
will o positioned after the new text upon completion of the 
imsgertion. 


The format of the command is: 
Itext$$ 
where “text” is the text to be inserted. 


The inserted text can consist of any valid text characters. 
Valid text characters are all printing characters, tab, 
cerriege return, line feed and form feed. 


Following are examples of the I command. The caret, “t", 
indicetes the position of the pointer after execution of 
each command. For purposes of illustration, line 
terminators ere depicted in these examples. The return 
tyeed by the user is represented es “<RET>"". The two 
character sequence generated by the return and stored in the 
text is represented as “<CR><LF>". XTECO’s prompt (''') is 
also shown in the examples. 





Command Text in Menery 
— R UPD2<CR><LF> 
“IPIP$$ R UPD2<CR><LF> 
PIPt 


“I DKO:=DK1:<RET> R UPD2<CR><LF> 
$$ _- DKO:=DK1:<CR><LF> 


COMMAND TEXT IN MEMORY 
oe FILE DK1:=DKt:<CR><LF> 
‘less FILE DK1:=DK2t:<CR><LF> 


B12 


~~ oe TT ~-  -— 


SEQ 0144 
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7.2.6 J Commend 


The J command is used to position the pointer at the 
beginring of all text currently stored in memory. 


The format of the command is: 
J$$ 


The commend is terminated by two altmodes or escepes which 
ere echoed on the terminal as "$$" as shown above. 


Following is an example of the J command. The caret, “t", 
indicates the position of the pointer before and after 
command execut on. 


initiel stete: 
R PROG] 
R PROG2 
R PROGT3 
After execution of the J command: 
*R PROG 


R PROG? 
R PROGS 


_ -_—-- ——_—_———_——_ 
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7.2.7 Command 


The * command is used to delete lines of text from the text 
storeo in memory. A line of text is a string of characters 
betusen oars ieee return/line feed ae. (This sequence 
S produced by typing the “return” key on your terminal.) 

Deletion of a line includes the deletion of the Sarees ing 
cerri return/line feed sequence in 5 ada to the 
cherecters in the line. Any number of lines mit be deleted 
either preceeding or following the current position of _ 
pointer. If the pointer is positioned within a line, no 

all of the line will be deleted (see examples that Follow). 


Tre formet of the command is: 


[n]K$$ 
where m is an optional argument that specifies the number of 
lines to be deleted. It is decimal number and is itive 


if the lines preceed the pointer and negative if they follow 
it. If this argument is not specified, “1” is ecouned. 


Following ere examples of the K command. The caret, “t", 
indicetes the Seals ten of the pointer after the execution ° 
each —_, XTECO’s prompt ('”') is also shown in the 
examples. 


Command Text in Memory 
-- sSTART OF CONTROL FILE 
tR PROG) 


R PROG2 
R PROGS 


R PROG4 
sEND OF FILE 
“K$$ sSTART OF CONTROL FILE 
tR PROG? 
R PROG3 
R PROG4 
sEND OF FILE 


“-1K$$ tR PROG2 
R PROG3 


R PROG4 
sEND OF FILE 


“evrss tR PROG4 
sEND OF FILE 


Die 


— _- 


SEQ 0146 


Ele 
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‘3C$$ R PTROG4S 
sEND OF FILE 
“K$$ R Pt;END OF FILE 


Note the effect of the K command when the pointer is not 
positioned at the beginning of a line. You can easily 
determine the effect of eny K command by yoed of a T command 
with the identicel format. Whatever is " eveed es 

issue the T command is what will be anlette t ~ Fo 
commend. (The commands 371 and 3K are of identical iit ) 


SEQ 0147 
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7.2.8 Ut Commend 


The . command is used to move the pointer on a line-by-line 
besis. A line of text is a string of characters between 
cerriege return/line feed sequences. (This sequence is 
produced by typing the “return” key on your terminal.) The 
pointer cen be moved either beckward or forward “~y number 
of lines in the text currently stored in memory. The 
pointer is always positioned at the beginning of a line 
after execution of the L command. 


The format of the commend is: 

[n)L$$ 
where m is an optional argument that specifies the direction 
to move end the number of lines encompassed by the move. It 


iS @ decimal number that is positive for forward motion and 
negative for beckwaerd motion. If it is not specified, "1" 


iS essumed. 
Following ere examples of the L command. In these examples, 
e ceret, "t", indicetes the ition of the pointer after 


execution of each command. XTECO'’s prompt (") is also shown 
in the exemples. 
Command Text in Memory 


on R ZRLAt?? 
IF ERROR THEN 
— RLO1 HAS HARDWARE PROBLEM 


"L$$ R ZRLA?? 
tIF ERROR THEN 
a ae RLO1 HAS HARDWARE PROBLEM 


“-IL $$ tR ZRLA?? 
IF ERROR THEN 
0 il RLO1 HAS HARDWARE PROBLEM 


"el $$ R ZRLA?? 
IF ERROR THEN 
— RLO] HAS HARDWARE PROBLEM 


Fie 


SEQ 0148 
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7.2.9  Coamend 


The N command has the effect of a “non-stop” S command. It 
is nae + the S command, except that it searches 
c) 


through remaining text in a file. 
The format of the command is: 
Nstring$$ 


where “string” is the character sequence to search for. 
This string can consist of any number of valid characters, 
including » cerriaege return and line feed. 


The editor searches through text in memory, starting from 
the current pointer position, until either a match is found 
or the end of text is encountered. If the editor fails to 
find a match for the specified string within the text 
currently in memory, it writes the text in memory into the 

t file and brings more text in from the in file. 
This process continues until either a match is found or the 
entire input file has been checked. 


The J command can not be used to recover from a failed 
search if thet search caused the section of text thet you 
started from to be written to the output file. In this | 
cease, you must exit edit mode and re-enter with the previous 


output file as input. 


Gle 


SEQ 0149 
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7.2.10 S$ Commend 


The S command causes the editor to search for a specified 
string of characters in the text currently stored in_ memory. 
Searches teke plece in the forward direction only. The 
search encompasses the text in memory only. 


The formet of the command is: 
Sstring$$ 


where “string” is the character sequence to search for. 
This string can consist of any number of valid characters, 
including » carriage return and line feed 


The editor searches through text in memory, starting from 
the current pointer position. until either a match is found 
or the end of text is encountered. An error message is 
printed if e match is not found. The pointer is positioned 
AFTER the string found by the search or after all text in 
memory if no match is made. (You can reposition the pointer 
to the beginning of text in memory after ea failed search by 
using the J command. ) 

Following ere examples of the S command. The caret, “tft”, 
indicates the pn of the pointer efter execution of each 
command. XTECO's prompt ('"') is also shown in the 


examples. 
Cc Text in Memory 


tR UPDAT 
PIP 0X0: -DX2:¢.BIN 
EXIT 


“SDX1$$ R UPDAT 
PIP DX0:=DX2:*«.BIN 
EXITt 

“J$$ tR UPDAT 
PIP DX0:=DX2:«.BIN 
EXIT 

“SDxX2$$ 


R UPDAT 
PIP DX0:=DX2t:*.BIN 
EXIT 


In the above example, the first search failed. The editor 
would print an error message: 


-~ . —7_ _— = ee © 


SEQ 0150 


Iie 
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“NOT FOUND: DX] 


_ — > =m ES TY —_—= ©. == Se + eee eee ———— 
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7.2.11 17 Commend 


The T command is used to type text on the console terminal. 
The text typed is relative to the position of the pointer in 
the text currently stored in memory. Typing is line-by-line 
and eny number of lines before or after the current pointer 
position be typed. A line of text is a string of 
cheracters between cerri return/line feed sequences. 
(This sequence is produced by typing the “return” key on 
your terminel.) If the pointer is positioned within a line 
of text, typing sterts/concludes at the pointer position 
(see examples). 


The format of the command is: 

[n]T$$ 
where n is an optional argument that specifies the number of 
lines to be t . It is ea decimal number that is positive 


if the lines Follow the pointer and negative if the preceed 
it. If m is not specified, "1" is assumed. 


HT is @ speciel form of the T command that causes all text 
currently stored in memory to be typed, regardless of the 
position of the pointer. 

Following ere examples of the T command. The ceret, “t", in 
the sample text indicates = poets of the pointer. 
XTECO's prompt ('"') is also in the examples. 

First semple text: 


;BATCH CONTROL FILE FOR TESTING THE DZ11 
tR ZDZA?? 


R ZDZ6?? 
sEND OF DZ11 TESTING 
Command Text Typed 


"T$$ R ZDZA?? 
“-1T$$ ;BATCH CONTROL FILE FOR TESTING THE DZi1 
R ZDZA?? 


"2T$$ 
R ZDZB?? 
Second semple text: 
R PROG] 


R PROTG2 
R PROG3 


J12 


— -2.-- —- < 


SEQ 0152 


SEQ 0153 
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Command Text Typed 
"T$$ G2 
“-1T$$ R PROG) 

R PRO 
“OT$$ R PRO 
“HT$$ R PROG1 

R PROG2 

R PROG3S 


—-e jee ee A TTT A me ———— ee ee ee 


Lie 
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7.2.12 ZJ Commend 


The ZJ command is used to position the pointer after all 
text currently in memory. 


The format of the command is: 
ZJ$$ 


Following is an example of the ZJ command. The caret, “t", 
indicetes the position of the pointer before and after 
command execution. 
Initial state: 

tR PROGI 

R PROG2 

R PROGS 


After execution of the ZJ command: 
R PROG 


R PROG2 
R PROGS 
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2 I Command The I command is used to insert new text. The 
text is inserted efter the current pointer position. he 
pointer will be positioned after the new text upon 
completion of the insertion. 


The format of the command is: 
Itext$$ 


where “text” is the text to be inserted. This text can 
consist of any valid text characters. Valid text characters 
are all printing characters, tab, carriage return, line feed 
and form feed 


Following ere examples of the I command. The caret, "t", 
indicates the position of the pointer after execution of 
each command. For purposes of illustration, line 
terminators are depicted in these examples. The return 
wees by the user is represented as "<RET>"". The two 
cherecter sequence generated by the return and stored in the 
LF>". XTECO's prompt ('"') is 


text is represented as "<CR>< 
also shown in the examples. 


Command Text in Memory 
-- R UPDAT<CR><LF> tf 
“IPIP$$ R UPDAT<CR><LF> 
PIPt 


“IT DKO:=DK1:<RET> R UPDAT<CR><LF> 

$$ PIP DKO: =DK1:<CR><LF> 
COMMAND ._ TEXT IN MEMORY 

-- FILE DK1:=DKt:<CR><LF> 

"I2$$ FILE DK1:=DK2t:<CR><LF> 


M12. 


SEQ 0155 
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7.3 Combining Edit Commands 


The user can combine several edit mode commands on a single 
command line. This is done by separating each command by a 
single escape (altmode) character and then terminating the 

entire string of commands by two escapes. For example, the 


following ¢ 


“NTEST$$ 
“OT$$ 
"T$$ 
can be combined into e single string: 


“NTESTSOTST$$ 


In both cases, XTECO will do a non-stop search for the 
string “TEST”, type the characters from the beginning of the 
line where the string was found to the current pointer 
position and then type the characters from the current 
pointer position to the end of the line. Combining commands 
is merely a convenience for the user. It is suggested that 
ou do not attempt to combine commands until you are 
emilier with the operation of individual commands. 
— section has sample edit sessions that show both 
methods. 


7.4 semple Edit Sessions 


Wheat follows is a series of sample edit sessions that show 
ou the various ways of handling XTECO. In these examples, 
he underlined cont is that which is typed by XTECO. At 


PL ES a NT ce mae 


appropriate locations, comments have been included for 
reader assistance. These comments are enclosed in square 
brackets ([]) and should not be confused with the actual 
dialogue that is taking place between user and software. 
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7.4.1 Sieaple Methed for Creating eo Text File 
R XTECO 


TEXT TEST.CCC 

[User creating new file on 

system device called TEST.CCC) 

“I;THIS IS A BATCH CONTROL JOB FOR TESTING THE RX01 
;THIS IS A FICTIONAL JOB FOR DEMO OF XTECO ONLY! 
: 

R ZRXX?? 

RES/PAS:1 

N 

EXIT 

;THE FIRST RXO1 DIAGNOSTIC HAS BEEN RUN. 

; 

R ZRXY?? 

RES/PRS:1/TES:1-5 

N 

EXIT 

sEND OF RXO1 TEST 

$$ 

“ExXS$$ 

Exit 


B13 


SEQ 0157 
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7.4.2 Changing on Existing Text File 
am XTECO 


TECO TEST.CCC 

[The user is going to change TEST.CCC, 

on the system device.) 

“SRX02$$ 

2 WOI EQUNO: &x0e2 

“J$s 

“T$$ 

sIHIS IS A BATCH CONTROL JOB EOR TESTING IHE Rx0l 
“L$$ 

“2T$$s 

sIHis IS & EICIIONAL JOB FOR DEMO OF XIECO ONLY! 
“EXSS 

EyI7 


ia 


-_=- _——_— — SS — —-. 


SEQ 0158 
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7.4.3 Use of Combined Edit Commands 
a8 XTECO 


EDIT 0L.1:7EST1.CCC=TEST.CCC 


(EDIT TEST.CCC, WHICH IS ON THE SYSTEM 
DEVICE, AND PLACE THE EDITTED OUTPUT 
INTO A FILE CALLED TEST1.CCC ON DL1.) 


“NPAS:$0TT$$ [SEARCH FOR “PAS:" AND TYPE LINE] 
RESZPAS21 

“DI2$OTT$$ [DELETE NEXT CHAR AND INSERT "2“) 
RES/PAS ze 

“EXS$ 

exI7 


7.5 Men-edit Commands 


There are three XTECO commands that sre not related to 
actual text file editting. These commands are provided for 
user convenience. 


7.5.1 TYPE end PRINT 


The TYPE and PRINT commands are used to print text files on 
the console terminal and line printer respectively. They 
sre equivalent to the UPDAT commands of the same name. 


D13 


wr ee Ge ee -- 


—- oo. _— —_— «= - 


SEQ 0159 
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7.5.2 EXIT 


The EXIT command is used to return control to the XXDP 
mon: tor. 


_—— — +e ae ———_—— ae + ——_— ee 


ria 


CHAPTER 8 
BATCH CONTROL 


XXDP hes a facility for running programs without operator 
intervention. This igh Fae is called batch control or 
chaining. The cos that would nerasl ty be issued by an 
operator ere put into a text file (using XTECO ) and the 
monitor processes the commands in this file rether than 
requiring en operator to enter each command menue!lly. 


8.1 DOescriptien 


Once @ betch control file has been created, it can be used 
over end over again. The batch control process releases you 
from having to do repetitive tesks such as building new 
medi@ or running ea common set of di tics. 

importantly. batch control lets you develop ea test strategy 
and use the strategy cons:stently. This is done by 
selecting the proper diagnostics end running them in 6 
perticuler order and mode to achieve the best test process. 
Once the process is developed, it is put into e batch 
control file. 


Older versions of XXDP had wry limited batch control — 
services. Essentially you could “chain” together @ series 
of en commands which would run various diagnostic programs, 
such es: 


You could intermix comments to be printed as the chain was 
processed. This primitive process was adequate for most 
simple procedures, but was not adequate for more 


SEQ 0161 
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sophisticated operations such as update kits. 


8.1.1 Betch Control Functions 


XXDP now contains », Soicsy guehiat ested set of batch 
control functions listed below. These functions and 
techniques for using them to run diagnostics and utilities 
ere described here. 


Batch Control Functions 


Monitor Commands monitor commands: R, LL. S, C, and E) 
Utility Commands UPDAT, SETUP, etc. 
DRS Commands ell DRS commands and diagnostic dialogue 


8.1.1.1 Meniter Coamands 


Certain of the monitor commands described in Chapter 2 can 
be used in a batch control file. They are the R, L. S, 

end E commends. There ere two functions which ere different 
when used under batch control instead of operator control. 
First, the R (Run) Command has ea pass switch for use with 
diagnostic programs which ere not DRS compatible. The 
diagnostic may be run es certsin number of passes by using 
the switch as shown: 


R DIAG/S 


DIAG will run 5 passes before the batch operation continues 
on. 


The C (Chain Command) may be used in a batch file with one 
restriction. Batch operations can be nested one level only. 
Theat is, a batch file may stert another batch file and then 
continue efter the second file has been processed, but the 
second batch file may not start another (third) file. 


With these exceptions, the monitor commands function under 
betch control as they would under operstor control. 


H13 
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8.1.1.2 Utility Commends 


The commands for various XXDP utilities may be used in batch 
control operations. 


8.1.1.3 ORS Commands 


All of the DRS commands described in Chapter 3, including 
oll switches and flags, can be used in a batch control file. 
All dialogue that would normally take place between an 
operator and e DRS diagnostic can also be placed in a batch 
control file. Batch Commands 


8.1.1.4 Betch Control Command Sunmmery 
The following batch control commands can be used: 
conditionals sections of the batch file can be 


processed conditionally under operator 
control or runtime conditions 


GOTO tag in processing at another section of the 
batch file designated by "tag" 

PRINT temporary override of QUIET 

QUIET inhibit printing of batch file if printing 


or enable printing if printing was 
inhibited previously 


QUIT terminate the batch operation 

SMI/CMI enable/disable manual —_—ss intervention 
operations in specialized diagnostics 

WAIT stop batch operation until the operator 
types a Control X 


8.2 Betch Control Coamends 


-~- =— © _—_ ——-_—— —_— + 


SEQ 0163 
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8.2.1 Conditionele 


Sections of a batch control file can be processed, or not 
processed, based on either operator input or certain 
conditions. There ere three conditional statements. 


1. IF condition THEN 
statement(s) 
END 


2. IFERR THEN 
statement(s) 
END 


3. IFLMD mn THEN 
stetement(s) 
END 


If the condition specified is true, the statements between 
the THEN and END statements will be processed. If the 
condition is false, these statements will be ignored. 


The conditions used in the first type of statement -“" ASCII 
cheracter strings which are defined by the person writing 
the betch file and used as switches by the operator. For 
exemple, sypgece ® person is writing e batch file for 
running UPDAT and doing some file operations. If ea part of 
the process requires the presence of an RX02 on the system, 
there would be a need for the operator using the batch file 
to be able to speci ty whether or not there was an RX02 
present. The batch file writer would define a conditional 
section of the file as shown below. 


IF RXO2 THEN 
stetement(s) 
END 


The condition “RX02" is now used by the operator as a switch 
to the Chain command: 


C FILE/RX02 


The monitor stores the string of characters for sengerseen 
with the conditions in the batch file. There is only one 
pre-defined switch and the writer is free to create | 
other he or she desires. The pre-defined switch is “/QV" 
(quick ver’ fy) which causes diagnostics to be run one pass 
only. Any number of switches may be used in ea command. 


— en «Eee 


Lae 


—— eee 
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The third type of conditional uses the media-type byte in 
physicel location 41. If the type code matches the one 
specified in the conditional ("nn"), the statements will be 
processed. 


8.2.2 GOTO 
The GOTO statement is used to transfer control within a 
batch control file. When the monitor encounters ea GOTO 


en elphanumer ic ering Corea by a colon (nem), The tag 
& 


may occur before or 
file. The following are examples of the GOTO statement: 


TAG1: 
R PROGI 
GOTO TAG 


GOTO TAG2 


TAG2: 

R PROGS 

In the first example, the batch process will loop backwards 
until interrupted by the operator. In the second example, 
control will be transferred forward to TAG2. Any statements 
between the GOTO statement and the tag are ignored. 


The PRINT statement is used to force the typing of a line of 
text while typing is inhibited by the QUIET statement. 


The format of the statement is: 


J13 
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PRINT text 
The text on the same line as the PRINT will be typed. 


8.2.4 QUIET 


The QUIET statement is used to control typing of the batch 
file. The statement is used like a ""flip-flop". The first 
time the statement is encountered, all typing iS suppressed 
(with the exception of error messages). The next time it is 
encountered, typing is reenabled. The third time it is 
encountered, typing is inhibited again and so on. 


8.2.5 @QuIT 


The batch job is immediately stopped when a QUIT statement 
iS encountered. The monitor returns to normal operator 


8.2.6 30/00 
The SMI and CMI statements sre used to enable and disable 
menuel intervention modes in DRS-type di tics. Normally 


ell testing that requires manual intervention by an operator 
are inhibited during batch control operations. These | 
statements allow this to be over-ridden. Obviously caution 
is suggested when using this feature. 


SMI - set (allow) manuel intervention 
CMI - clear (don't sallow) manual intervention 


CMI is the default state when a batch job is sterted. 


8.2.7 WAIT 


When @ WAIT statement is encountered, the monitor stops 
processing the batch file and waits for the eperster to ty 
oe CTRL-X (typed by depressing the CTRL and X keys together). 
This is typically used in conjunction with manual 
intervention feature as shown in the example below. 


K13 


—e ee 


——— 


——_———e ——-- = 
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XXDP User's Guide -- Batch Control Page 8-7 


PRINT THE NEXT DIAGNOSTIC REQUIRES THAT A 
PRINT SCRATCH MEDI.“ BE MOUNIED IN THE RLO1/02. 
PRINT TYPE tX WHEN READY 


WAIT 
R ZRLA?? 


8.3 Comments 


Comments can be included in the batch file. Comments are 
typed as the file is processed unless QUIET mode is invoked. 
A comment is a string of text that starts with a semicolon. 


THE NEXT PROGRAM TESTS THE DZ11 
R 20287? ;RUN THE DIAGNOSTIC 


8.4 Betch Control of Diegnostics 


For the purposes of batch control, there are two types of 
diagnostics: chainable ag pa oo diagnostics and 
DRS-type diagnostics. The first type can be batched by a 
simple run command: 


R DIAG[/n] 
where n is an optionel argument that cifies the number of 


pesses that the diagnostic will run. The default is one 
pass. 


DRS-t diagnostics require complete batch control. All 
Soe rmally entered by an operator must be in the 


c no 
batch file. For exemple: 


R DIAG2 

START/PASS:1 

Y answer for CHANGE HW) _ 

1 enswer for number of units] 


[insert answers for all HW questions) 
EXIT [to return control to batch job] 


This is just ea short example. The concept to note is that 
the betch file is an INDIRECT COMMAND file for DRS. All 


113 
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commends that ere required when running under operator 
control are necessary in the file. If the diagnostic 
Pp am in the above example had used a software table, it 
would have been necessary to provide the commands required 


to support it. 


The user does not have to enter all commands via the batch 
file however. Sy using the SETUP pod Hy Ae ol 6), all 
herdwere and so/ were information could eypes ied to the 
diagnostic prior to running the batch job. This is the 
recommended method for using DRS-type diagnostics in the 
batch control environment. If you preset all the 
perameters, the following commands are all that are 
necessary: 


R DIAG2 
ieee 
N 
EXIT 
where n is the number of passes to execute. 


8.4.1 Diegnestic Abort 


A DRS diagnostic in a chain file can be aborted by and tC or 
e tZ. If you abort with a tC, the chain file can test for 
the tC and alter the flow of control. For example: 


R DIAG 
N 


EXIT 
IF _tC THEN 

GOTO L1 

END 

If you abort with a tZ, the chain file cannot test for it 
and the flow of control cannot be changed. 


8.4.2 Batch Control of Utilities 


Most of the XXDP utilities can be used under batch control. 
The utilities thet ere batch controlable are: UPDAT, SETUP, 
and PATCH. To run a utility under batch control, simply 


M13_ 
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create a batch file that _ Sentnses all of the commands that 
are normally entered by on cperater For example, to build 
an nn Ol f loppy Stonetes for XXDP using UPDAT under batch 
contro 


CREATE DYO 

FILE DYO: =DRSXM. SYS 
FILE DYO:=DIR.SYS 
os he :*=DY.SYS 


Note that the dialogue with UPDAT must end with an EXIT 
command in order to finish the batch job or to allow further 
batch furctions. 


SEQ 0169 
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APPENDIX A 
GLOSSARY 


This is a glossary of common terms used in connection with XXDP. 


autodelete - a possible effect of the 4 Sraneter process 
whereby a file from the input a. -% CeDA aces a file of the 
seme name on the output Bo od AT. only transfers 
initiated by e FILE command can nau in sutodeletion. | 


boot block - the first physical block an e medium (block zero). 
bi, block contains the XXDP secondary bootstrap for the 
v:ce. 


bootstrap - very simple code used to load and stert more complex 
code from e medium such es a disk. The term comes from the 
phrase gfe oneself up by the bootstraps”. See aslso 
“primary bootstrap” and “secondary bootstrap”. 


buffer - a section of memory reserved for storing date, usually 
from ea file, as opposed to executable code 


console terminal - the video or hardcopy terminal attached to the 
system vie the Di interface at bus address 177560. 


device driver - thet softwere which hes the function of 
controlling the operation of a specific hardware component 
in @ system. An RX02 driver, for exemple, is that software 
thet eccomplishes such tesks as pga Sip 5 es fmxeiset % block, 
reading e block of information, etc. on 


device handler - see ‘device driver” 


eum - the process whereby an image of the contents of memory is 
placed on a storage medium. 


eat - to modify text information in eo file 


—< — ee = - 
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editor - s utility program used to modify text files 


hardware table - data structure where DRS stores the information 
regarding units being tested 


load - the process whereby the contents of a file containing a 
program image are placed in memory. 


medium - physical storage such as a disk or magtape. In _ this 
menuel, the term “medium” is equivalent to "XXDP medium”. 


pess - a unit of diagnostic operation. A ODRS-type diagnostic 
pass is defined to be execution of all specified tests on 
ell active units. 


patch - a temporary remedy for a problem in a program that is 
os oa ag by altering the program image stored on the 
ium, 


physical block - a group of data consisting of 256 (decimal) 
words. This is the standard size of date transmission to 
and from the XXDP media. 


physical location - an sysolute memory reference (see “virtual 
location”). 


or lenny Soe - code, usually stored in a ROM, which loads 

t “boot block” (block 0) from a medium into the first 256 
(decimal) words of memory and then transfers control to 
memory location 0. 


program buffer - a section of memory used by UPDAT for loading 
progrem images. 

secondary bootstrap - code that resides in the boot block (block 
) of eo medium. This code is losded snd started by the 
primary bootstrap and in turn loads an starts the XXDP 
monitor. 


softwere teble - date structure where DRS stores information 
regerding operations] characteristics of a diagnostic 


Switch - e modifier for ea command 


system medium - the medium on the device from which the XXDP 
System was booted 


text - e@ collection of ASCII formatted data consisting of 
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printing cheracters, tebs, carriage returns and form feeds. 


virtual location - e reletive mero: reference. A program image 
thet hes been losded int» § > program buffer by UPDAT uses 
vietuel seaet sents thet —*. program location 0 is not 
physicel memory location C, .c is the first physical memory 
location in the progrem buffer. The XXDP monitor does 
absolute loads in this case program location 0 is not 
vietueal, but is actually memory location 0. 


XX? medium - physical storage, such as a disk pack, MAGtape, 
cessette, etc.,. that has been formatted for XXDP use. 


——_—_— —— ee — 
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APPENDIX 8 
COMMAND SUMMARY 


This appendix summarizes the following: 
Monitor Commands 
DRS Commands. Switches, and Flags 
UPDAT Commands 
PATCH Commands 
XTECO Commands 
Betch Control Functions 


-_— * — _—_— — — « —— —_——-- 


Command Summary 


8.1 Menitor Coamends 
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8.1.1 SM Meniter Coamends 


zrwMMoM 


~~ or 


EST 


run e@ batch job (chain) | 
list directory of load medium 
enable alternate system device 
set the terminal fill count 
type help information 
load ea program 
run @ program 
stert oe pyre 
file: 


run betc SYSTEM.CCC 


8.1.2 MN Meniter Coamends 


Help 
Initialize 
Loed 


Boot a device : 

run @ batch job (chain) 

Copy a file or device 

Set the date or report the date 
Delete a file : 
list directory of load medium 


F14 


eneble alternative drive for system device 


t help information 
Initial ize @ device 


2 am 
Print e file on the system line printer 


Reneme e file to 8 new name 
run @ progrem 

Set device or system parameter 
stert e program 

Type a file 


. A A LG i 
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activate . unit for testi 

cont inue Sapenk te et test that was 
inte hist 1 tC 

print e list of device information 

deactivate ea unit 

return to XXDP rust ign monitor 

print stetus of all f 

print stetisticel information 

continue from en error halt 

stert diagnostic and do not initialize 

start the Gi agnostic and initialize 

reset ell flags 


/EOP : ddddd report end-of-pass after each ddddd pesses 
/FLAGS: fl sae : : bo ty ote f] 

: -lis se wo magedn @ 
/PASS: : execute 4dc Po 1 to 64000) 


/TESTS:test-list execute on] SS oo ee specified 


/UNITS:unit-list command will affect only specified units 


8.4 ORS Flegs 
Flag Effect 
ADR execute sutodrop code 
BOE “bell” on error — 
EVL execute evaluation 
HOE halt on error 
IGE inhibit ell error reports except first level 
IDR inhibit program dropping of units 
IER inhibit ell error reports 
ISR inhibit staetisticel reports 
IXE inhibit extended error reports 
LOE loop on err - 
LOT loop on test 
PNT print test number as test executes 
PRI direct messages to "Tien printer 


unattended mode (no manual intervention) 


SEQ 0175 


assign e logical name to a device 
bootstrap e device 

clear UPD2 progrem buffer 

Soey entire um 

delete a file or files 

give directory of specified medium 
execute an indirect command file 
load e device driver 


dum @ program image 

write logicel end-of-tepe mark on oe tape 
return control to the runtime monitor 
transfer a file or files 

set upper memory limit for dump 

load a progrem a Se 

set lower memory limit for dump 
modify file image in memory 

trenster ea file or files — 

print a file on the line printer 
read e file to check validity 

rename a file ; 

seve a monitor on e disk 

seve e@ monitor on ea tape : 

type a file on the console terminal 
set transfer address 

initialize eo medium 
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8.6 PATCH Commands 


Boot specified Gevice 


Save input table 
Print input teble on terminal 


114 


ome ~— —_— 


SEQ 0177 


J14 


7 
Command Summary Page B-6 oan Gare 


8.7 XTECO Commends 
8.7.1 WNen-edit commends 


EDIT - modify e file 

EXIT - return to monitor 

PRINT - print ea file on the line printer 
TEXT - create new text file 

TECO - modify a file on disk 

TYPE - type a file on the console terminal 


8.7.2 Edit Commands 


& append text to that currently in memory 
C move the pointer character Sv cheracter 
D delete character(s) 

EX - exit edit mode 


insert text 

move the pointer to the Seginning of text 

delete line(s) ; ; 

move the pointer line ov line : ; 
search for specified string in remainder of text file 
search for specified string in text now in memory 
type text 

move the pointer to the end of text 


NAW Ze ACH 
64 4G as 8.9% 6 
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8.8 Betch Control Functions 


Monitor Commands 
Utility Commands 
DRS Commands 
conditionals 


GOTO tag 
QUIET 
PRINT 


SMI/CMI 


QUIT 
WAIT 


monitor commands: R, L, S, C, and E) 

UPDAT, SETUP, etc. 

ell DRS commands and diagnostic dialogue 
sections of the batch file can be 
processed Compt enae ty under operator 
control or runtime conditions (e.g. IF, THEN) 


pears processing at another section of the 
h file designated by “tag” 


inhibit printing of batch file if printing 
or enable printing if printing wes 
inhibited previously 

temporary override of QUIET 


enable/disable manuel intervention 
operations in specialized diagnostics 


terminate the batch operation 


stop batch operation until the operator 
types a Control Xx 
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APPENDIX C 
DEVICES SUPPORTED 


XXDP supports most mass aterees ¢ Geviene. The Riga es 
table, lists ell devices supported, the mnemonic used t 
specify the device and the name of } + A. the file. 


Device Mnemonic Driver DISTRIBUTION MEDIA 
RPO4/5/6 dB 0B 

TUS8 DD DD TUS8 
RLO1/2 DL DL RLO1 / RLO2 
RKO6/7 DM DM RKO6 / RKO7 
RMO02/3 DR DR 

RX02 DY DY RxX02 
PRINTER LF LP 

TMO2 MM MM 800 BPI MT 
TS04 MS MS 1600 BPI MT 
UDASO DU DU 

RD/RX DU DU 


All drivers assume that the CSR address for the device is 
the standard address as given in the Peripheral Handbook. 
If you have ea system with a device at a non-standard 
eaeeaee. you can modify location 12 in the driver using 


XXDP device drivers are, by aqeonni ty. 8 tg and limited in 
function. They can detect and repor Spee of errors: 
read, write and hard. These errors are ge =. oy trol 
is returned to the utility being used. The oe 

tekes any further action required. Since the functionality 
of the drivers is limited, the user is required to run 
diagnostics on the device in question if an error persists. 


—_— + — Se ee ee ee 
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APPENDIX D 
COMPONENT NAMES 


All the component file names begin with the letter H. The 
om letter in the neme determines the component type, as 
ollows: 


o.. ae 

oe iiity p reams 
D-- device drivers 

S -- runtime services 
Q-- manuals 


The third and fourth letters indicate the component name and 
the last two letters are the version numbers. 


The utility programe ere distributed under their common 


nemes, like end XTECO, for user convenience and have 
.BIN (or .BIC) extensions. 


et —— ee - 
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Description File Name Release Name 
MONITOR files 
XXDP V2 RESIDENT MONITOR XXDPSM.SYS HMSM??.SYS 
ee V2 EXTENDED MONITOR XXDPXM.SYS HMXM??.SYS 
XXDP V2 DATE UTILITY DATE .SYS A??.SYS 
XXDP V2 DIRECTORY UTILITY DIR.SYS HUDI??.SYS 
XXDP V2 HELP FILE HELP. TXT HQLP??.TXT 
DRIVER files 
RPO4,.5.6 DRIVER & BOOT DB.SYS HDDB??.SYS 
€& BOOT DD.SYS HDDD??.SYS 
RLO1/2 DRIVER & BOOT DL.SYS HDDL??.SYS 
RKO06/7 DRIVER & BOOT DM.SYS HDDM??.SYS 
RMO2/3 DRIVER & BOOT DR.SYS HDDR??.SYS 
DRIVER & BOOT SYS HDDU??.SYS 
RX02 DRIVER €& DY.SYS HDDY??.SYS 
PRINTER DRIVER LP.SYS HDLP??.SYS 
TMO2 DRIVER & BOOT MM.SYS HDMM??.SYS 
TS04/TS11 DRIVER & BOOT MS.SYS HDMS??.SYS 
UTILITY files 
XXDP V2 DECK11 CONFIGURATOR DXCL .BIC HUXC??.BIC 
XXDP V2 UPDATE ety UPDAT.BIC HUP2?7?7.BIC 
XXDP V2 PATCH UTILITY PATCH.BIC HUPA??.BIC 
XXDP V2 SETUP UTILITY SETUP.BIC HUSU??.BIC 
XxxXDP V2 XTECO UTILITY XTECO.BIC HUTECO.BIC 
UFD files 
XXDP V2 UFD MENU UTILITY MENU?0.8IC HUMEBO.SYS 
oaS files 
XXDP DIAG SUPR SML DRSSM.SYS HSAA??.SYS 
XXDP DIAG SUPR EXT DRSXM.SYS HSAX??.SYS 
Documents 
XXxDP FILE STRUCT DOC N/A CHF SBO . DOC 
XXDP V2 FILE STRUCT DOC N/A CHQ??7?70.D0C 
XXDP DRIVER PROGR GUIDE N/A CHQ???7?.D0C 
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APPENDIX E 
BUILDING XXDP 


E.1 Meniter end Required Files 

The minimum files that must be put on a bootable XXDP medium 
ere the monitor for that medium, on és vice driver for that 
medium, the DRS (file mame: DRSS. eves or DRSX.SYS) and the 
directory utility (file name: DIR.SYS). The monitor file 
(file name: ) must be loaded b y UPDAT and then saved on the 
medium using either the CREATE. at nth "Tasos commands are 
described in Chapter 4. 


he remaining files may be put onto the medium using any 
Peat file transfer commends. 


Examples (RX02 and 1TS04): 


am UPDAT 

CREATE DO: 

FILE Dv0:=DY.SYS 
FILE Dv0:=DIR.SYS 
FILE DvO:=DRSXM.SYS 
€/I7 


2? PDF” 
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CREATE MSO: 

PIP MSO:=MS.SYS 
PIP MSO:=DIR.SYS 
PIP MSO: =DRSXM.SYS 
Exit 


The process described ebove places the MINIMUM XXDP system 
on e@ medium. You can edd as many other system components 
(drivers and yell tiee) es you uteh, Don't forget to modify 
location 370 in the XXDPXM monitor if you are using a system 
thet is on SOHz power. (Location 370 must contain ea zero 
value for 60Hz and ea non-zero value for SOHz. ) 


E.2 Updste Kits 


The file XXBLD.CCC is a batch control file that 

updates/bui lds XXDP aesis automatically. To start the file, 

use the chain command. The file accepts switches that 

specify the media Svea. to build and the mode in which to 

ot hey All supported XXDP media may be built. The media 
built are always assummed to be mounted in drive 

Cont ) 0 of the device and that the drive is ready and 

wr i te-enabled. 


The format of the command line for starting the build 
process is: 


C XXBLD/dev ice[ /mode ] 


Gevice - the mnemonic for the device to be bu lt/updated. 
Supported devices and their mnemonics are listed 
in appendix C. If no device is spec fied, @ short 
help message will be printed. 


mode - manner in which to build/update. Available moces 


ORIVER @ bootable medium with el] “XDP drivers 
MONITOR @ bootable medium with el] XXDP monitors 
JTILI7’ @ bootable medium with el] X*xXDP utilities 
S’STEM 8 combination of the above three modes 


-* mo moge “s specified, 8 bootable medium is built. A 
bootable mea um cons sts of 9 Dootable monitor ‘mage, the 


Cis 


SEQ 0184 
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runtime services, the directory utility, the driver for the 
medium and UPDAT. 


Except in the case of sequentiel devices (e.g.; magtape), 
the medium is not ch except for the Soul 
replacement/addition of the new XXDP components cified by 
the mode switch. You may want to back up files that are 
critical however. Sequential media are destroyed. 

warning message is produced end you are given 

opportunity to ebort the process. 


To obtein help while running the update batch job, use the 
following command: 


C XXBLD/HELP 


-—_———— —_——— SE EE ee 
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APPENDIX F 
USER TIPS 


F.1 ORS Table Building 


To save time and energy. prebuild the hardware and softwere 
tables in a diagnostic using the SETUP utility. Customize 
the files for e specific system on the XXDP medium for that 
system or customize files for several systems on medium 

ered between systems. Remember, you cen elways change the 
tables on the fly by using the START command or permanently 
change the files by using SETUP. 


Another way to make XXDP work for you is to use the batch 
control functions described in Chapter 8 of this manuel. 
Femilierize yourself with the DRS-type diagnostics for a 
perticuler device and identify the various operating modes 
(as defined by the softwere tables) that ere most useful for 
you. Prebuild the hardware tables for the system, or 
Systems, you ere working with. Then write ea batch control 
file thet implements the verious modes based on 
conditionals. This sllows you to enter one command to XxDP 
and then let the system do the rest. 


A simple example of this type of batch control file is 
follows. For the purposes of this exemple, we will use e 
fictional diagnostic called "DIAG1”. The normal operator 


diel with this diagnostic (with hardware tables already 
built) is: 
R DIAGI 
>STA 
HA Hi ths i N 
HA W : Y 
L SECTORS (L) 2 


Tre batch 1,3 thet hes been created for this diagnostic is 
celleo “DIS".CCC” and is listed below. 


~~ — ** —_—_—— ~——_— —— - 
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IF QV THEN 
R DIAG 
STA/PAS:1 


— 


IF a? THEN 
STA/FLA:LOE 


xz 
Oo 
nl 


<= 


This file defines two test modes: quick verify and repair. 
Note how the batch file manipulates the software questions 

and also avoids agp at the hardware questions since the 

tebdles were elready created. The user invokes either of the 
two modes with one of the following command 


C DISK/QV 
or, 


C DISK/REPAIR 


oo-- —_—-=-—-— - 


- =. -_—_ =—- 


SEQ 0187 


APPENDIX G 
ERROR MESSAGES 
The error messeges thet could occur during an operation are 
listed alphabetically below. The louep eben letters “device 


error” refer to a series of specific errors that can be 
detected by the device drivers. The possible errors are 
listed after the error messages. 


2 ADDRESS NOT FOUND (PATCH) 
The specified address does not exist as an entry in 
the input table. 


? BAD ADDR (Monitor) 
An invelid address wes specified with ea run or start 
command. 

? CHECKSUM ERROR (Monitor, UPDAT, PATCH) 


Each block in @ binary file hes a checksum stored in 
it. If the checksum calculated while reading the | 
block does not match the checksum in the block, this 
error is printed. Try the operation again, but the 
file was probably corrupted. 


? COMMAND NEEDS ARGUMENT (PATCH) ; 
The command typed by the operator requires an 
ergument., but none was given. 


? DELETE OLD FILE (PATCH) : 
The specified output filename already exists. 


2? DEVICE BOOT BLOCK NOT INITIALIZED (Monitor ) : 
An attempt to boot a device that does not contain an 
intielized boot block will be reported as shown and 
the device will not be booted. 


? device error (Monitor, UPDAT) 


G15 
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SEQ 0188 
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Each read/write device driver may detect en error 
during en operation. The driver reports the type of 
error and returns control to the program being used. 
This program appends any additional information as 
—_ in the so yn error messages. The errors that 
on ee engper tes by drivers are: READ ERROR and 


2 device error DIRECTORY (PATCH) 
The specified device error occured during the 
ration indicated. Possible device errors are: 
AD (error occurred while reading a block of 
date), WRITE ERROR (error occurred while writing a 
block of data) and HARD ERROR (error occured during 
@ non-transfer operation). 


2? device error ON INPUT DEVICE (Monitor, UPDAT PATCH) 
The specified error occurred on the input_device 
specified in the last operator command. f the 
error gererete, the media or the hardware may be 
ae, ry running diagnostics for the specific 

vice. 


2? device error ON INPUT DEVICE DIRECTORY (Monitor, ye 
The specified error occurred while accessi 
directory on the i device specified in 4 ae 
rator command. [here may be problems with either 
device or the media. Try running diagnostics 
~ the device. 


? device error ON OUTPUT DEVICE (Monitor, UPDAT,PATCH) 
The specified error occurred on the input Gevice 
specified in the last operator command. If the 
— gerei ete, the media or the hardware may be 

ry running diagnostics for the specific 
> 


2? device error ON OUTPUT DEVICE DIRECTORY (Monitor, UPDAT) 
The specified error occurred while accessing the 
directory on the — device specified in the last 

retor command. re may be a with either 
the device or the media. Try running diagnostics 
for the device. 


? device error WHILE LT ee DRIVER FOR dev 
Monitor, UPDAT ,PATCH) ; 

The specified error occurred while the driver for 

the specified device was being loaded into memory. 


Ii5 
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? device error WHILE READING filename 
(Monitor ,UPDAT,PATCH) The specified error 
occurred while the specified file was being read. 


? DEVICE FUL |. (Monitor, UPDAT) 
The capacity of the output device hes been exceeded. 
For disk devices (random access), there are not 
yey physical blocks remaining to store the file. 
Any blocks allocated during the attempt to write the 
file are dealloceted. For tepe devices (sequential 
access), the physicel end-of-tape mark was reached 
while the file was being written, In both ceses, no 
file is created. Delete some existing files or use 
another medium. 


2 DIRECTORY FULL (Monitor, UPDAT) 
There are no remaining entries in the directory and 
the name of the file and other date cannot be 
entered. No file is created. Delete some existing 
files or use another medium. 


END-OF -MEDIUM (PATCH) 
While readi e file, the end of the file was 


encountered before it was expected. 


ERR HLT : CDRS) 
A halt-on-error has occurred. DRS is now back at 
command mode. Halt-on-error a occurs if operator 
hes specified this mode with a flag to DRS. 


? FILE ALREADY EXISTS (Monitor ,PATCH) 
The name of the file specified for output matches 
thet of a file that already exists on the output 
medium. Delete the old file or use a different 


~~ 


name. 

? FILE NOT FOUND _CPATCH) 
The specified input filename does not exist. 

? FILE TOO BIG (PATCH) 


ILL INTER ann PC annannn Ps nnnnnn (DRS) 
An unexpected interrupt occurred through vector nnn. 
The Program Counter and Processor Stetus Word at the 
time of the interrupt ere given. 


INPUT TABLE EMPTY (PATCH) 
The specified command cannot be executed because 
there are no entries in the input table. 


~~ 
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INPUT TABLE FULL (PATCH) 
The input table is full and cannot accept any more 
entries. 
INSUFF MEM CORS) 


There is not — memory space to store table 
information 6 the number of units that the user 


wents to specify. 


INVAL SWTCH FOR CMND (ORS) 
The user specified @ non-existent or non- licable 
switch in the previous commend. Refer to the table 
of switches Chapter 3. 


INVAL UNIT CDRS) 
The user specified a unit that does not exist. 
ates ADDRESS (PATCH) 


An eddress given in the last command was not seep! 
(possibly en odd number). Check the command 
re-enter properly. 


THVAL TD ADDRESS CUPDAT) 
There are three operations that can cause this 
error. One, when using the MOD command to modify ea 
virtual location, the address of the location given 
wes odd or not within the upper end lower core 
diaite. Two, the address — in @ LOCORE command 

higher than the curren py A 8 core limit. And, 

wee. the eddress given in a HICORE command wes 
lower than the current low core limit. 


INVALID COMMAND (Moni tor , UPDAT ,PATCH) 


You have entered a command that is not recognizeble. 
Check the command (especially spelling) and re-enter 
properly. 

INVALID DEVICE (Monitor, UPDAT,PATCH) 


This ay hes 68 a of causes , dependi ing on the 
command be ing wee For file related commands (DIR, 
COPY, ZERO, SAVE, ScavM’ DEL. BOOT and EQT), one of 
the devices specified is not file- structured (like 
paper tape). For EOT, the device is @ non-tape 
device. For COPY, the specified devices are not 
identical types. 


tis FILENAME (Monitor, UPDAT, PATCH) 


You specified a filename in the previous command 
thet was not in the proper format. 


—— ——e - — 


Js” 
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? 


? 


INVALID MODULE NAME (PATCH) 
A DEC/X11 module name was incorrectly specified. 


INVALID NUMBER _., (Monitor, UPDAT, PATCH) 
A number specified in the last command was not 
entered property. Possible problems are: not a 
number (e.g., lee4) or not proper radix (e.g., 1292 
is not octal). 


INVALID SWITCH (Monitor, UPDAT) 
The last command was entered with a switch that is 
not recognized by UPDAT. Re-enter the command 


properly. 


LOGICAL DEVICE NOT ASSIGNED (Monitor, UPDAT) 
An attempt was made to use a logical unit number 
—— ieee assigning it to a device. (See ASG 
c " 


LOOKUP ERROR fi lnam CORS) 
This error_message actually comes from the XXDP 
monitor. If the file mame is DRSXM.SYS or | 
DRSSM.SYS, then the diagnostic being run requires 
the DRS, but the DRS file is not on the system 
medium. Any other file name indicates that the 
diagnostic attempted to open a file that does not 
exist on the system medium. 


LOOP CHNG : CDRS) 
The range of the loop changed while looping on error 


wes if progress. 


MEMORY ERR AT LOCATION: xxxxxxxx (Monitor) 
A nonexistent memory or @ memory gar ity error 
occurred at the location ified. If the type of 


error is detected that will also be reported. 


E le: 
> MEMORY PARITY ERR AT LOCATION: xxxxxxxx 


MODULE NAMES NOT ALLOWED WITHOUT MAP FILE (PATCH) 
The rator attempted to specify a module name in 
oe command without first loading the proper MAP 

1ie. 


MODULE NAME NOT FOUND (PATCH) 


The specified module name does not exist within the 
DEC/X11 runtime exerciser. 


—_————_— i 
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2 MUST - EVEN (PATCH) 
The operator attempted to specify an odd number as 
en eddress. 
2 MUST ee OCTAL (PATCH) 
The operator attempted to type a non-octel number. 
? NEED NUMBER (PATCH) 


~~ 


~~ 


'~ 


The operator omitted a numeric value from a command 
thet expected one. 


NO DEVICE DEFAULTS (PATCH) 
Default device names are not allowed. 
NO UNIT CDRS) 


There ere no active units. Either no units have 
been specified or all units have been dropped. 


NOT ENOUGH ROOM TO LOAD DRIVER (PATCH) 
The driver for the specified device will not fit 
into memory. 

NOT FOUND CUPDAT, PATCH) 


The file specified for input in the last command wes 
not found on the device specified. 


NOT FOUND: XX.SYS CUPDAT ) 

The driver for device “xx” was not found on the 
system medium. This message is printed by the 
monitor driver which is used to load device drivers 
for UPDAT. Transfer the required driver file to the 
system medium. 


NOT FOUND: filnem (Monitor) 
The specified file was not fyuund by the monitor. 
The monitor can only read files that are on the 
system medium unless a specific device is specified. 


NOT FOUND: xx.SYS (Monitor) 
The hag. for device “xx” was not found on the 
oyeten dium. Transfer the required drive file 
(XX. SYS) to the system medium. 


NOT HALTED CORS) 
The user attempted to enter ea PROCEED command when 
the DRS had not executed a “halt-on-error” sequence. 


NUMBER TOO BIG _ _CPATCH) 
The value typed was too large for its intended 


- ————_— 
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purpose. 

? OPTION MODULE NAME NOT FOUND (PATCH) 
The specified option module does not exist. 

? OVERFLOW (Monitor, UPDAT) 


An attempt was made to load too large a program into 
the progrem buffer. oped tte 


PASS ABORTED FOR THIS UNIT (ORS) 
peing test wes > preguereiy ended for the current unit 
ed. There is usually en error message 
the dlaapestts given prior to this message. 
sa to the specific diagnostic documentation for 
the reason that the unit may have been aborted. 


? READ ERROR (Monitor) 
A device error occured while reading. Retry the 
operation. 

? SPECIFY DEVICE (Monitor, UPDAT, PATCH) 
The lest command specified does not allow the use of 
default device specifications. Re-enter the command 


with the device(s) explicitly specified. 


? seen (Monitor, UPDAT, 
The lest command was entered improperly. Re-enter 
the command properly. 


TRAP ERR AT: mnnnnn CORS) 
An unrecognized TRAP instruction was executed. The 
bt instruction is used to communicete between the 
in Field ¢ end DRS. This error should never occur 
ld operation. Please report the problem if it 


TST TOO BIG (DRS) 
The user specified ea test number that is lerger than 


the number of tests in the diagnostic program being 
run. 


? UNEXPECTED END-OF -FILE (Monitor, UPDAT,PATCH) — 
The logical end of a file was encountered before it 
wes expected. The file in question is corrupt. 


2? UNEXPECTED INTERRUPT FROM: xxxxxxxx (Monitor ) 
An unexpected interrupt occurred from the indicated 


-- _——_————— aoa —— ~~ eee 


— 
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location. 

? WRITE ERR ~ : ae (Monitor) 
A device error occurred while writing. Retry the 


operation. If the error as reported from the driver 
ee aayp hte ig xg = ~e “ies epee - P 
repor appending this information to end o 

the above report. Some errors that be detected and 

easily corrected by the user would be the case where 
the device is write locked or does not have a write 

ring in stelled. 


Cxempies 
? WRITE ERR - DKO: WRITE LOCKED 


?WRONG MAP FILE FOR MONITOR TYPE (PATCH) 
The MAP file in memory does not have the specified 
monitor type. 
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Abbreviations 
Mc 

ACT, 6-1 

Add 

DRS, 3-7 

ADR, 3-24 

ASG 
UPDAT, 4-6 


Batch 
conditionals, 8-4 
monitor commands, 8-2 
Betch control, 8-1 
batch control handler, 2-2 
BOE. 3-24 


. 2-16 


PATCH, 5-4 
UPDAT, 4-7 


Boot 
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Chain 

xm, 2-18 
chein 

sé. 2-7 
Characters 


INDEX 
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continue, 3-8 
eneny. 3-9 
-10 


SM 


chain, 2-7 


enable, = 


stert, 2-13 


summar 
aentter. 2-6 
XM 


abbreviations, -* 


t 
Compatibility 
with DRS, -] 
Conditionals, 8-4 

Console commands, 3-2 
console terminal driver, 2-2 
Cont inue 
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DRS, 3-8 rop 
Control S, 3-10 
betch, 8-1 DRS, 1-2, 3-1 
Control characters, 1-4 Concepts, 3-2 
Convent ions error format, 3-4 
file, 1-4 Start-up, 3-2 
terminal interface, 1-3 DRS Commands 
cor in batch, 8-3 
UPDAT, 4-9 DRSSM, 3-1 
an 9 DRSXM, 3-1 
e- 19 
D EDIT command, 7-3 
XTECO, 7-8 Editi 
Dete stert-up, 7-3 
XM, 2-20 i Enable 
DEC/XC11 map files, 5-19 XM, 2-23 
enable 
UPDAT, 4-11 SM, 2-9 
Delete /EQP, 3-20 
xm, e-2l1 EOP J 
DEPO, 4-3 switch, 3-20 
Device OT 
_Grivers, C-1 UPDAT, 4-18 
iegnostic EVL, 3- 
requirements, 2-2 x 
restrictions, 2-3 XTECO, 7-9 
Diagnostic Runtime Services, 3-1 EXIT 
Diagnostic runtime services, 1-2 PATCH, 5-6 
2 UPDAT, 4-19 
UPDAT, 4-12 XTECO. 7-26 
Director Extensions 
. -} special, 1-5 
at ag 
ry c- FIL E 
Digeley _UPDAT, 4-24 
S. 3-9 File conventions, 1-4 
Sao 
UPDAT, 4-14 modification, 4-2 
DRIV required, E-1 
POAT, 4-16 /FLAGS, 3-21 
Drivers Fl » 3-23 
loadable devi ce. 1-3 ADR, 3-24 


supported, C-: BOE, 3-24 
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DRS. 3-11 
EVi. 3-25 
» 3-25 
IBE, 3-25 
IDR, 3-26 
IER, 3-26 
ISR, 3-26 
IXx€, 3-26 
LOE, 3-26 
LOT, 3-27 
PNT, 3-27 
I. 3-27 
Sui tch, 3-21 
V M, -27 
7™ 
on 5-7 
PATCH, 5-86 
GOTO, 8-5 
Hardware 


peremeter tables, 3-3 
requirements, 2- 


IFLMD, 8-4 


J 


ad 
SM, 2-11 
Loadable device drivers, 1-3 


LOCORE 
UPDAT, 4-22 
LOE, - 6 
LOT, 3-27 
Map files 
“Bec/xii. 5-19 
ry requirements 
SET ? 6-1 
PATCH, 5-10 
UPDAT, 4-23 
Monitor, 1-1 
command summery, 2-6 
Command eyeten, 2-15 


run, 2-1 
start, 2-13 
XM 
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boot, 2-17, 2-28 
chain, e- & 


2 
initielize. : 25 
losd, 2-31 
me. «: 233 


mon tor services handler, 2-2 


N 
operator interface handler, 2-2 
/PASS, 3-21 


Pass. 3-3 
Nate 3-21 
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UPDAT, 4-27 

XTECO, 7-25 
Print 

XM, 2-27 


Proceed 


DRS, 3-12 


READ 
UPDAT a 4-28 


read-write device driver, 2-2 


UPDAT, 4-29 
Requirements 

di tic, 2-2 

hardware, 2-3 


SETUP 
SET 8 6-1 
Restart 
DRS, 3-15 
Restrictions 
diagnostic, 2-3 
un 


S 


PATCH, 5-17 
Services 
diagnostic runtime, 1-2 


run, 2-l2 
start, 2-13 
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SM moritor, 2-1 
Software 

peremeter tables, 3-3 
Speciel cheracters, 1- 


stert-up process, 2-4 


T 
XTECO, 7-18 
Tables 


Terminel interface 
conventions, 1-3 
Test, 3-4 
/TESTS, 3-22 
Tests 
Switch, 3-22 
TEXT command, 7-3 
HEN 


Time. 
DRS, 3-18 
TYPE 


PATCH, 5-18 
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’ 2-32 


Wildcards 


in file specifications, 1-4 


XFR 
UPDAT, 4-31 
XM 


boot, 2-17, 2-28 
chain, 2- a 
Command syntex, 2-15 
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help, 
init:elize, 2-25 
00d, 2-26, 2-31 
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4 eBsr ACH 


sterti » 7-3 
18° 


monitor, E-] 
required, E-1 


ZERO 
—"* 4-10, 4-32 
Dre, 3-19 


XTECO ° 7 -20 
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